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Fastball, slider, or change-up. 
dBASE, Paradox, or Oracle. If you 
want to connect, you know 
you’ve got to react fast. 

With the comprehensive 
lineup of over 20 drivers in 
INTERSOLV ODBC Pack, you can. 

Cover all your bases with 
INTERSOLV. 
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applications, your network, and your 
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Insider 
secrets! 



"Sourcer combined with Windows 
Source should be mandatory for 
looking into Windows Programs." 

Sal Ricciardi - PC Magazine 




Discover the secrets the insiders use 
with Windows Source! 


Learn the numerous undocumented 
functions used by the professionals to 
perform tricks that are otherwise im¬ 
possible! 

Windows Source™ generates detailed 
listings of Windows EXEs, DLLs, and 
VxDs. See the actual Windows func¬ 
tion names used within the programs. 

Windows Source includes the follow¬ 
ing special features: 

❖ Identifies all imported function 
calls, including Windows API calls. 

❖ Labels all exports from an execu¬ 
table, DLL or device driver. 

Includes Codeview symbols when 
available. 

<♦ Identifies, by name, the VxD API 
entry points and services provided. 

<♦ Describes DPMI, DOScall and 
VMM interrupt subfunctions. 

There is no way to get better commented 
assembly source code from Windows 
programs. Bundled with Sourcer for 
DOS binary file disassembly. 

Just $229.95! 

Call 800-648-8266 
to order now! 

y..~7Z7 V Communications, Inc. 

\\ V4320 Stevens Creek Blvd., Suite 275-WD 
V San Jose, CA 95129 FAX 408-296-4441 
408-296-4224 



From 

the Editor 


Why won't install programs leave my autoexecbat alone? The most recent 
intruder is the install program for the Borland C++ 4.02 update, which sud¬ 
denly got a lot stupider in several areas, including not displaying how much 
disk space the options you want to install will consume. I'm glad to get the 
4.02 update, but I wish they would label their disks with complete version 
information - now I have three different (but identical-looking) Borland CD- 
ROMs, all labeled '4.0'. ♦♦ Scott Meyers' column in the July/August issue of 

C++ Report makes the interesting assertion that you should avoid having con¬ 
crete (non-abstract) classes inherit from concrete classes. I probably won't 
make that my own hard and fast rule, but I certainly agree with the accompa¬ 
nying argument that people are looking for code reuse in the least likely place: 
C++ classes. You just can't make (for example) one linked list C++ class that is 
best for all circumstances. ♦♦ I thought editing a Windows programming 
magazine was a tough gig, until I picked up a copy of a magazine called 'Cold 
Fusion' (800-234-8458). That's right, it's devoted to the promotion of cold fu¬ 
sion (generating energy from water) and it's published by none other than 
Wayne Green, a name veteran ham operators will recognize. You can order 
your own cold fusion reactor for $100,000 or, if your research budget is a little 
low, just buy a year's subscription for $98. ♦♦ Trying to understand VxDS, I 

struggled through the documentation, drawing lots of pictures. I suddenly un¬ 
derstood that all VxDS share a repetitive framework and I even painted a pre¬ 
liminary user interface for a VxD code generator. I think it's a neat idea, and 
now Vireo Software (508-779-8352 or Vireo@vireo.com) is shipping VtooIsD, a 
VxD development toolkit that includes what sounds much like the code gener¬ 
ator I envisioned. ♦♦ We continue to expand our email services, and now 
you can use email to order books. Did you see a book in Books in Brief that 
your local bookstore doesn't have? Just send email to rdorders@rdpub.com 
and give them the book, title, author, and publisher, along with your VISA or 
MasterCard number, expiration date, name, and phone number. ♦♦ Send 
email to techinfo@borland.com to learn about Borland's new electronic news¬ 
letter. I just got my first installment, which has half of a two-part article on 
using OLE v2.01 with Borland C++ v4.x; it shows you how to make some of 
the Microsoft-centric code in the OLE SDK and in Kraig Brockschmidt's book 
Inside OLE 2 work with Borland C++. The latter blithely assumes that everyone 
uses Visual C++ (the slowest PC C++ compiler and, as far as I know, the only 
C++ compiler in the world that does not support templates). 

Ron Burk 

Editor 

CIS: 70302,2566; Internet: ronb&rdpub.com (“... luunetlrdpublronb") 
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Graphics 


An Interpretation of ROPs 
for 24-Bit Color 

Dave Boll 


=E3= 

Borland C++ V4.02 
Visual C++ vl .5 

Mi 

Watcom C/C++ vl 0.0 


Many aspects of Windows can be traced directly back to the work done at 
Xerox PARC. In particular, bitbits (bit block transfers) were first developed as 
instructions on the Xerox PARC Alto machine, and appear in Windows as the 
API function BitBltO. If the bitblt were a simple copy of a source bitmap to the 
screen, it would be too inefficient for many situations. For example, a common 
use for bitbits is XOR a cursor or rubber-band-line bitmap to the screen, then 
XOR it again to erase it quickly without having to save the original screen 
contents. If bitblts were simple copy operations, you would have to read the 
destination bits, XOR them with the source bits, and then write them back. 
Instead, the original Alto bitblt instruction implemented the concept of a 'raster 
operation', or ROP. Assuming both the source and destination bitmaps were 
monochrome (each pixel was one bit), the ROP specified which one of 16 pos¬ 
sible Boolean functions should result from combining those two bits. By setting 
the ROP to XOR, for example, you could then execute a bitblt instruction to 
XOR a source bitmap to the screen without having to explicitly read the screen 
bitmap first. 

The Windows BitBltO function adds a dimension that the original bitblt 
instruction did not have; it lets you combine the current brush (also called the 
'pattern' in the context of discussing ROPs) of the output device context with 
the source and and destination bitmaps. In other words, BitBltO lets you use 
three input bits (sometimes called a ternary ROP), rather than two (a binary 
ROP), to set the output bit. There are only 16 possible Boolean functions of two 
input bits, but there are 256 Boolean functions of three input bits, and Win¬ 
dows supplies 256 ROP codes (the final argument of BitBltO) to support them 
all. Figure 1 shows the general scheme; ideally, the device driver being written 
to (e.g., a display or printer driver) will be able to use hardware support to 
implement BitBltO efficiently. 


Dave Boll received a B5 degree in Astronomy and Astrophysics from the University of 
Wyoming and an MS in Computer Science from Colorado State University. He is cur¬ 
rently working as a software development engineer for Hewlett-Packard, in Vancouver, 
WA. He can be contacted at dboll@vcd.hp.com. 
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winPAK - The C++ Custom Controls 

Finally there are controls created expressly for Windows C++ 
programmers. winPAK unleashes the full power of C++. winPAK controls 
are FAST! winPAK is compatible with Borland C++, Visual C++ and 
Symantec C++. Borland C++ programmers even get access to the winPAK 
internals, can derive their own new classes from winPAK, and override 
internal features. Try that with a VBX control! winPAK is a single DLL that is 
fully compatible with Borland Resource Workshop. Look at winPAK’s 
impressive lineup: 


A Full-Featured Spreadsheet 


Bitmaps galore: in radiobuttons, 
checkboxes and listboxes. Use 
our winPAK controls as direct 
replacements for the standard 
controls. Use the hierarchical 
listbox for outlines and trees. Full 
horizontal scrolling is supported 
automatically. 


1- It’s a spreadsheet! Connect 
cells together with expressions. 

2- It’s a grid! Connect it to any 
ODBC-compliant database, 
without any need to code! 

3 - It's a virtual listbox! Up to 2 
billion items. 

Use the mouse at runtime to change 

cell, column or row properties. 

Bitmapped Windows Controls 




Part No. 

Description 

Unit Price 

1 

i 

1 

PCL-2-50 

• 2 Pencils 

4.95 

2 

ERS-1-12 

Pendl eraser 

2.25 

3 

PAPWHT-8 

White Paper 

1.99 

4 

MSPAD-1 

Mouse Pad 

0.75 

S 

PEN-3-10 

Black pen 

2.49 

6 

STPL-3 

Office stapler 

2.35 
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Instrumentation Controls 

winPAK has all kinds of controls for 
analog variables: faders, gauges, 
completion status bars, knobs. 
winPAK has the best looking 
controls in the business. winPAK 
gives you full control over how each 
item looks on the screen, with little 
or no coding necessary! 


winPAK has everything for data 
entry. Let winPAK check characters 
and do range checking or data 
conversion for you. winPAK handles 
strings, picture-template strings, 
integers and floating point numbers. 
winPAK’s error reporting is 
unsurpassed! 


All winPAK controls are compatible 
with Resource Workshop. Each 
control has its own set of detailed 
and easy-to-use property sheets, to 
let you tune each control with 
immediate feedback. Certain 
controls even have a proprietary 
Integrated Designer. 

Little or no coding needed - Just add winPAK controls to your resource file, 
and we take it from there. Properties are usually established under 
Resource Workshop, but runtime changes can also be made. 

winPAK comes with 19 bullet proof controls - We even make the 
source code available! So what are you waiting for ? Call our order desk at 
(800) 500-6535 to order! winPAK is priced at only $249.95. winPAK with 
source code is $499.95. VISA or MasterCard accepted. Fax your order to 
(714) 854-6459, or use CompuServe at 76350, 1013. Call for a free demo 
disk. winPAK comes with a 30 day money-back guarantee. No royalties. 


Properties, Properties I 



Validated Data Entry 
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As long as all the input pixels (source, destination, 
brush) consist of exactly one bit, ROPs have a straightfor¬ 
ward meaning. Windows extends them to handle 16-color 
pixels essentially by viewing each pixel as four bits (red, 
green, blue, and intensity) and performing the ROP on 
each bit. However, it would be nice to use the power and 
speed of ROPs in domains where the input and outputs to 
the ROP are not Boolean - namely, in the 24-bit (8 bits 
per color per pixel) realm. This poses an interpretation 
problem, however; as Figure 2 shows, it is not clear how 
to implement Boolean operators (such as AND, XOR) with 
essentially real-valued inputs. This problem has a number 
of consequences. First, since there is no consensus on how 
these ROPs should be implemented, they have been im¬ 
plemented in different ways on different drivers, with re¬ 
sults confusing to the user. If, say, a video driver performs 
a ROP one way, but the printer driver performs it a sec¬ 
ond way, then the user is likely to see printed output that 
doesn't match the screen - which will be viewed as a 
defect in the application. Second, most peripheral drivers 
don't truly support most ROPs. And, finally, since applica¬ 
tions cannot trust peripheral drivers to do ROPs consis¬ 
tently, applications developers end up writing the code to 
do it themselves, at a considerable cost in performance. 

This article describes a more reasonable interpretation 
of ROPs in the 24-bit world, and provides a short C pro¬ 
gram capable of doing any of the 256 possible ROPs us¬ 
ing 8-bit inputs. 

ROPs with 1-Bit Pixels 

If the bitmaps involved in a drawing operation such as 
BitBltO are ail monochrome (1 bit per pixel), ROPs are 
easy to understand. BitBltO calculates the new value of 
each destination bit from three input bits: one bit from the 
destination bitmap, one bit from the source bitmap, and 
one bit from a brush (pattern) bitmap. The ROP specifies a 
Boolean combination of these three input values, and the 
resulting bit is written to the destination bitmap. 


Figure 1 The BitBltO ternary ROP 


Current 

brush Source Destination 

(pattern) bitmap bitmap 
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LAUNCH BAR 

FrontRunner’s Launch Bar offers 
one-button launching of your favorite 
applications. Customize it any way 
you like! 

COPY & PASTE 

Just highlight and click to copy and 
paste any part of your DOS session into 
a Windows or DOS program. 

COMMAND LINE POWER 

Run DOS or Windows programs right 
from the DOS prompt! 

• 

POWERFUL REAL TIME 
STATUS BAR 

FrontRunner’s Status Bar displays 
real-time information including 
system resources... and lets you 
write modules to display your own 
up-to-date information! . 


Bringing the best of DOS to 
Windows... And the Power 
of Windows to DOS 

Frustrated with switching between 
Windows and DOS applications? Now 
you can get the command-line power 
you need — integrated with the 
Windows graphical features you want. 
Phar Lap FrontRunner is a powerful 
DOS-based Windows desktop that 
brings intuitive GUI features to 
command-line DOS. FrontRunner lets 
you run Windows programs directly 
from the DOS prompt, provides an easy- 
to-use, menu-driven alternative to 
Program Manager, lets you launch 
applications with a click, keeps custom 
information at hand with Phar Lap’s 
unique Status Bar, and much more! 


SIMPLIFIED RUN MENU 

Run Menu offers Program Manager functionality 
without navigating through all those open windows! 


HISTORY 

Scroll to view the complete 
history of your DOS session. 
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FRONTRUNNER OFFERS YOU: 

✓ A Better DOS Box — Scroll and 
view your entire DOS screen 
history and run Windows programs 
direcdy from the DOS prompt 

✓ Quick and Easy Program Manager 
Replacement — no more searching 
through all those windows 

✓ Customizable Launch Bar — instant 
access to your favorite programs 

✓ Powerful Visual Batch Language 
Extensions for DOS — easily 
create visual front ends 

✓ Programmable Status Bar — view 
the real-time information you need 
most 

✓ Versatile Utilities — to enhance 
your productivity 



Or To Get Your 
free Demo! 



Now you can test ride a winner with our 
free FrontRunner Lite and Guided Tour 
Demo disks. FrontRunner Lite is a trial¬ 
sized version of our DOS desktop for 
Windows that lets you try all of 
FrontRunner’s powerful features... 
absolutely free! So call today and see 
how exciting a winning DOS desktop 
can be! 



60 Aberdeen Avenue, Cambridge, MA 02138 617-661-1510 FAX: 617-876-2972 


Phar Lap® and FrontRunner® are registered trademarks of Phar Lap Software, Inc. All other product names and company names are trademarks or registered trademarks of their respective holders. 
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The Windows SDK documentation specifies a standard 
form for identifying a ROP, based on a truth table organ¬ 
ized in a certain sequence. For example, the following is 
the truth table derivation for ROP B8 (B8 is the hex num¬ 
ber that identifies which of 256 possible ternary ROPs this 
is): 

pattern: 1 1 1 1 0 0 0 0 

source: 11001100 

destination: 10101010 


result: 10111000 = B8 

The first three lines consist of all possible combinations 
of values the three input bits could take on. The final 
line specifies what you want the output bit to be for 
each possible set of inputs. You don't actually pass 
0X00B8 as the final argument of BitBltO, however. In¬ 
stead, you must look B8 up in a table in the appendix 
of the Microsoft Windows Programmer's Reference, then 
pass BitBltO the 32-bit hex constant you find there. 

Deriving the Meaning of a ROP Code 

Suppose you are writing a display or printer driver 
and you have to implement BitBltO, including handling 
all 256 possible ROP codes. To perform the ROP on the 
three input values, a graphics driver must either look up 
the resulting value using a table such as the one shown 
above, or perform a Boolean equation that gives 


Imagine a tool that finally gives polymorphism 
the attention it deserves... 

Imagine a tool that provides a direct, 
straight-forward mapping onto C++... 

Imagine a tool that stands by your side, 
not in your way... 


Introducing... 

Object Foundry, 

An OO/C++ Design and Development Tool 


Engineered to help you tackle your toughest object- 
oriented development projects from people who know 
the importance of having the right tool for the job. 


Featuring: 


Reverse engineering 
Automatic diagram generation 
Automatic design document and code generation 
On-demand consistency checking 
Complete user-extensibility 
* Compatible with any C++ compiler 
Complete support for project teams 
Supports distributed client/server designs 


For more information, call: 513-291-2924 


iiSoftBSTC 

Tools, Consulting & Training tor OO/C++ Development 

Horizons 

P.O. Box 59261, Centerville, OH 45459 *513-291-2924* FAX: 513-885-5725 


□ Request 291 on Reader Service Card □ 


Page 8 — Windows/DOS Developer’s Journal 


equivalent results. Some sort of table look-up may well be 
the fastest way to implement the equations, since there 
are only 2x2x2x256 = 2048 different combinations of 
source, destination, pattern, and ROP. However, to extend 
the interpretation of a ROP out to 8 bits per pixel de¬ 
mands a less memory-intensive solution, since such a ta¬ 
ble would have 256x256x256x256 = 4,294,967,296 differ¬ 
ent entries. 

Logic functions like ROPs have been extensively stud¬ 
ied since the 1950s, when George Boole invented Boolean 
algebra for working with them. In particular, the effort to 
'minimize' Boolean functions - that is, to produce the 


Figure 2 Trying to apply ROPs to 24-bit color 
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TX Text-Control 
DLL brings 
true WYSIWYG 
Text Processing 
to your WINDOWS 
j Application 

Features 

Multiple fonts • Paragraph formatting • Zooming • Macrofields 
Optional integration of images in various formats • Low cost 
version available for Visual Basic 

GET YOUR FREE DEMO TODAY! 

Call 913 832 2070 (North and South America) 

European Software Connection, RO. Box 1982 
Lawrence, Kansas 66044, USA 
Fax: 913 832 8787, CompuServe: 71141,3624 

Elsewhere contact 

DBS GmbH, Kohlhokerstrasse 61,28203 Bremen 
Germany, Phone: +49 421 33 591 -0 
Fax: +49 421 339 8658, CompuServe 100013,115 
Or download TXDEMO.ZIP from CompuServe 
(Forum WINSDK, section PUBLIC UTILITIES) 
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Build Faster & Cleaner SQL Programs 


Optimizing SQL 

by Peter Gulutzan and Trudy Pelzer 

Optimizing SQL explains the basics 
and subtleties even some experts 
don’t know. Careful comparisons 
demonstrate how to improve SQL 
performance and 17 rules-of-thumb 
guide efficient applications. 


Learn ODBC and dynamic 
(machine-generated) 
embedded SQL 

This book explains Microsoft’s Open Database 
Connectivity interface. You will also learn how to 
embed SQL in C, how and when to use indexes, and 
coding for portable applications. 


Optimizing 
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Peter Gulutzan 
Trudy Pelzer 


Embedded SQL in C 


TL 



OPTIMIZATION RULE-OF-THUMB 


# 1 


If you have two or more ANDerf expressions put 
the most limiting expression first. 


Query A 
SELECT * 

FROM ITEMS 
WHERE PRICE = 600 


Query B 
SELECT * 

FROM ITEMS 
WHERE .35 = DISCOUNT 


Query A 

DBMS #1 100% 

DBMS #2 100% 

DBMS #3 100% 


Query B 
200 % 
200 % 
200 % 



Optimizing SQL 

also contains these programming aids: 

■ A summary of SQL commands. 

■ A "Hello World" program demonstrating static 
embedded SQL. 

■ A lengthy sample program in dynamic 
(machine-generated) embedded SQL. 

■ A "toolkit" program for checking index status. 

■ A complete sample ODBC application. 

■ 17 rules-of-thumb for more efficient SQL. 

■ A free enclosed diskette with: 

- All programs In the text 

- Sample database libraries for DOS and 
Windows 

- An embedded SOL Precompiler 


Order Your Copy Today! 

Use code V01 for Optimizing SQL with disk. 


Book with disk 

$ 34 ?§ 


plus shipping 



DISK 

INCLUDED 



Technical 

Books 


913-841-1631 
FAX: 913-841-2624 


VISA 
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simplest and most efficient implementation for a given 
logic function - has resulted in several standard tech¬ 
niques (such as Karnaugh maps and the Quine-McCIuskey 
method) for simplifying a given function. For functions of 
only three input variables, though, a little inspection and 
tinkering often suffices to simplify the function, making it 
more understandable and easier to implement. 

To simplify the implementation of the ROP B8, I begin 
by rewriting the B8 ROP logic table shown earlier in the 


form of a Boolean equation. In this equation, I use capital 
letters for bits equal to 1 (R=result, P=pattern, S=source, 
D=destination) and lowercase letters for bits equal to zero. 
As usual in writing Boolean equations, concatenation of 
two symbols implies the AND operator, and '+' represents 
the OR operator. You can turn a logic table into a Boolean 
equation by looking at which inputs cause a 1 for the 
output. For example, the logic table for ROP B8 can be 
directly written as: 


R = PSD + PsD + Psd + pSD 


Quadbase-SQL leads the 
pack in ODBC + DBMS 

|uadbase-SQL is an industrial strength, ANSI 
SQL 89 level 2 client/server RDBMS. Now it 
provides a unique ODBC driver that delivers 
superior performance by serving as a native API. 

To build applications, you can 

use the Quadbase-SQL Client 
Development Kit for Windows 
(which includes the local SQL 
engine as well as a set of 
powerful tools) with 
popular languages such 
as Visual Basic, C/C++ 
as well as any ODBC 
compliant front-ends/ 
languages such as 
ACCESS, FOXPRO 
for Windows, 

PowerBuilder, etc. 

Visual Basic development is enhanced by embedded SQL and bound custom controls. 

An interactive query tool/report-writer for Windows is included for quick prototyping and 
database administration and maintenance. A ‘C’ language API is also provided together with 
an embedded SQL preprocessor. 

You can deploy your applications in any environment from individual notebooks or desktops 
to peer-to-peer or client/server LANs. Quadbase-SQL XB Server (our client/server version) 
is available for both Novell Netware and Window NT. 

Advanced features of the SQL engine include declarative referential integrity with 
CASCADE, SET NULL and RESTRICT options, scroll cursors, SQL 2 compliant multi-table 
outer join, concurrency control through 4 isolation levels, crash recovery, transaction 
processing, BLOB data-type, and read-only schemas for CD ROMs. The high-performance 
engine is especially designed to manage large amounts of data efficiently. The Xbase file 
format allows easy migration from Xbase enivomments. 



Call for a free demo disk now. 

Find out why AT&T, 
Airbus, EPA, Xerox 
and many more major 
organizations use 
Quadbase products. 



Quadbase Systems, Inc. 

2855 Kifer Road, Suite 203 
Santa Clara, CA 95051 
Tel: (408) 982-0835 
Fax: (408) 982-0838 


In English, you could read this as 
'The result is 1 when all inputs are 1, 
or when pattern and destination are 
1 while source is 0, or when . . ..' 
You can then start minimizing the 
function by applying the laws of 
Boolean algebra: 


R = P($D + sD + sd) + pSD 
R = P( SD + s) + pSD 
R = Ps + PSD + pSD 
R = Ps + SD 


Factor out the P 
Cancel D+d 
Distribute the P 
Cancel P+p 


This simplified equation can be tran¬ 
scribed into simple procedural code: 

IF (S) return 0 
ELSE return P 

Another way to describe this last 
Boolean equation is with Reverse 
Polish Notation (RPN). The SDK uses 
this form to describe Windows ROPs, 
using capital letters for operands and 
lowercase letters (n=NOT, a=AND, 
o=OR, x=XOR) for operators. Rewrit¬ 
ing the Boolean equation 

R = Ps + SD 

in RPN produces 
PSnaSDao 

Note that I'm really working back¬ 
wards here; usually you choose the 
ROP based on intent rather than de¬ 
riving intent based on the ROP. Fiow- 
ever, if you are writing a driver and 
need to implement all 256 ROP 
codes, you have to start from the 
ROP code. 

The 'if/then' expression of this 
ROP sounds like something quite use¬ 
ful for an application to request, but 
it is difficult to derive this interpreta¬ 
tion of the ROP from the name of 
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A t The Programmer’s Shop, we've cut our prices across the 
bo^B help you save money on the tools you need. Every issue of 
VJt ■grammer's Shop Catalog showcases over a thousand products, 
languages, libraries, programming tools, client/server 
VenviBnents, business productivity packages, communications solutions, 
systems, and more. 

We’ve also developed innovative programs to help you shop more 
efficiently. CD Select lets you try out software products on CD before you 
buy them. Our new MegaGuide CD gives you product and pricing 


y 

Ck 



information on over 2,500 titles (see over). Plus, if your 
company purchases a lot of software, our Priority 
Accounts program is just the thing for you. Substantial 
discounts and priority service will save you valuable time 
and money. We even offer comprehensive customer 
training services to get you up and running fast. 

If it’s been a while since you’ve given 
The Programmer’s Shop a look, ask us 
to send you our latest catalog. 


Here’s just a smaU sample of what you can expect in every issue of 

~itai( 





The Programmer’s Shop Catalog: 


SmartPad Telegram 

Build the perfect Toolbar. STOP. 

Add automation. STOP. 

Create custom Shells and Suites. STOP. 
Enhance User Interface. Add 
ButtonClues/Ballon Help. STOP. 

Any Windows application. STOP. 

PS Price $ 77 


Prodea - Custom Solutions From 
Shrink-Wrapped Software 

Develop business applications that automate everyday 
tasks without programming. ProdeaSynergy works with 
popular Windows applications and features variable 
passing and complex logic for advanced process 
automation. 

PS Price $ 165 


Syncrzy 


—i 


C and C++ Documentation 

C-DOC™ 6.0 saves time and effort. 
It analyzes C and C++ source code 
and generates caller/called tree- 
diagrams and class tree-diagrams 
(as ASCII text files or using a 
Windows™ graphic-tree viewer). 
C-DOC lists or reformats source, 
counts source lines, and calculates 
path complexity. C-DOC generates 
function comment blocks to self¬ 
document programs. 

PS Price $ 149 




Powerful UNIX Development 
Tools - Now for your PC 

Mortice Kern’s MKS Toolkit v4.2 delivers 
190+ development tools once available 
only on UNIX. Includes Komshell, Vi 
Editor, AWK prototyping language & 
compiler, UUCP communications, 

Make automatic configuration builder, 
Windows Interface, Complete 
Documentation and Data transfer - 
and more. 

PS Price $ 199 
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Visual Baler 1.0 for Windows 

Ever wish you could create royalty-free runtime 
programs with a spreadsheet? Now you can! Visual Baler 
enables spreadsheet users and developers to build and 
distribute secure, standalone, MS Windows spreadsheet 
applications. Visual Baler starts where traditional 
spreadsheets stop. Import worksheet data from Lotus 
1-2-3, MS Excel and Quattro Pro in ,wk3/.fm3 file 
format. Output royalty-free .EXE Windows programs 
with custom Microsoft help files and bulletproof security. 
Includes graphical 3-D spreadsheet editor with tabbed 
pages, visual interface editor for custom dialog boxes 
and tool bars, and much more. 

PS Price $ 309 


The all-in-one productivity software 
package for OS/2 

NEW VERSION - Lotus SmartSuite 1.1 for OS/2 
includes Lotus 1-2-3, Freelance Graphics, Ami Pro word 
processor and a users license for cc:Mail E-mail. Pass 
information from one program to another through one 
consistent environment. Learn one, and you’ll know 
them all. Whether you work alone or on a network, 
SmartSuite will help you work better in OS/2. 


PS Price $449 


Give us a call at 1800-421-8006 


Mon.-Fri. 8:30-8:00 EST 


Turn the page for more ways 
to shop smarter . 
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CA-REALIZER 


Finish your software projects 
in record time 

Track Record, from the original developers of 
BRIEF, is a powerful tool to help developers 
keep track of bug reports, feature requests, test 
cycles, documentation reports, and more. 
You’ll produce better quality programs in less 
time, and with fewer support hassles. Get on 
track - Get Track Record today. 

PS Price $ 135 


Affordable, cutting-edge 
BASIC apps for Windows & 
OS/2 

CA-Realizer combines a structured 
superset of BASIC, complete support 
for Windows and OS/2, with 
programmable application tools to 
easily incorporate charts, spreadsheets, 
forms, animation, and more. 

Includes debugger, visual form 
designer, support for DDE, DLLs, and 
serial communications. Unlimited 
royalty-free runtime. 

PS Price $ 79 



Pizazz Plus 4, 

For Windows and DOS 

The Best Printing Utility also converts files, 
displays graphics, modifies images, captures 
the screen, supports 600 printers, and more. 
“Pizazz Plus is the best program for 
viewing and adjusting colors” 

PC Week 

“ With Pizazz Plus / can crop, rotate, and 
smooth the ragged edges...as well as 
modify the colors, shadings, sized, and 
proportions. It's well worth the price. ” 
Home Office Computing 

PS Price $ 99 


SQA Teamtest 


The most powerful automated test tool for GUI 
client/server applications combines the speed and 
ease of Object-Oriented Recording with the power 
and control of a complete programming 
environment. Object-Oriented Recoding retains 
objects, not simple mouse movements/keystrokes, 
providing position independent and extremely 
reliable script. Built on a networked test 
repository providing integrated defect tracking 
and reporting. The first automated GUI test tool 
to provide specialized support for Powersoft’s 
PowerBuilder and Gupta SQLWindows 
applications. 


PS Price $ 1,199 



C++ Foundation Class Library for 
Object-oriented Programming 

Tools.h++, an internationalized data 
structure class library from Rogue Software, 
includes classes like String, Time, Date, 
Collection Classes, Regular Expressions, and 
more. Available for DOS, OS/2, UNIX, NT, and 
MAC, and compatible with most 
contemporary C++ compilers. 

PS Price $ 269 




HelpBreeze 1.6 

This award-winning help authoring 
system turns Microsoft Word 6.0 or 2.0 
into a point and click environment for 
developing Windows help files. 
Automatically converts printed 
documents to help files and vice versa. 
Complete support for implementing 
context-sensitive help in Windows 
applications. 

PS Price $ 255 




Powerful make utility from OPUS 

Compatible with Microsoft Nmake, Borland 
Make and Intersolv Config.Builder/Polymake 
utilities, it also integrates with most popular 
version control systems. These features, with 
Opus Make’s speed, multiple directory support, 
conditional & looping capabilities, automatic 
response file support, object library 
maintenance, the Memory Miser, and much 
more, distinguish Opus Make as the most 
powerful make utility you can buy. 

PS Price $ 149 


Easier, better, more affordable 
database applications design 


CASEwise’s GenIE is a powerful set of 
Windows-based analysis and design tools that 
focus on pictures, not words. Client/server or 
desk-top applications - use GenIE to create 
professional design specifications and 
automatically generate database schema. 
Unique multi-user capability, SQL DDE 
reporting, WYSIWYG output and Cue-Card 
learning provide a flexible design environment 
at an affordable price. 


PS Price $ 489 
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Run UNIX & DOS 
simultaneously, with hill access 
to networked UNIX resources 


Visionware’s XVision 5.1 - fastest PC X 
server on the market. Smart features such 
as Object-oriented Desktop and Dynamic 
Graphics Optimization are unavailable on 
any other PC X server. XVision combines 
utilities such as Line Print Driver, File 
Transfer, VT320 Terminal Emulation and 
a 32-bit server with built-in intelligence, 
making it easy to use. 

PS Price $ 369 



At The Programmer's Shop, 

We’ve developed new programs to help you make the most intelligent 
purchasing decisions possible - not based solely on price, but in 
relation to your specific needs. From our “try-before-you-buy” CD 
Select to comprehensive product training - The Programmer’s Shop 
helps you to maximize the value of your purchasing decisions. 

Priority Accounts 

Designed specifically for large volume customers. 

• Priority Pricing • Priority Tracking • Technical Conferences 

• Priority 800# • Priority Shipping • FREE CD Select 

• Assigned Priority Account Representative • and more! 

Customer Training 

Want to incorporate a new product into your operations, but not sure you’ll know 
how to work with it? We now offer comprehensive training on many products, to 
help you get up and running fast! 



; WINBATCH EE 



WinBatch Language Compiler 

The custom Windows utilities programming 
tool for consultants and network 
administrators that give you batch 
capabilities Microsoft failed to include. 
Functions control the Windows GUI, 
applications, and networks. Batch .EXE for 
royalty-free distribution. Compiler includes 
a copy of WinBatch Windows batch 
interpreter. 

PS Price *369 


CD Select 

An exciting, innovative approach which will forever change your software 
evaluation, buying and delivery experience. 

• Test drive dozens of full-featured software titles on CD. 

• Eliminate the risk of blind purchases. 

• Get instant delivery - call us and we’ll give you a key code that unlocks the 
product to download immediately onto your hard drive. 

MegaGuide CD (featured below) 

Gives you instant product and pricing information on over 2,500 software titles. 


Hie liisiesi wav to iiiid ike software you need 


Introducing 

MenaBuide 

• Your guide to over 2,500 
hard-to-find products 

• Easy-to-use - just point and click 
to find the information you need 

• Powerful - with full-text search 
and structured queries 


Now you can get even more 
information, on even more products, 
in an even more convenient format. 
With this new Programmer’s Shop CD-ROM, you get 
product and pricing information on over 2,500 
products - instantly. Find information whichever way 
you want: by manufacturer, by product name, or by 
browsing through the relevant product category. Simply 
point and click to jump to the information you’re 
interested in. 

Use MegaGuide’s full-text search to find every 
occurrence of a word or phrase. Or create queries with 
multiple search tenns, for even more flexibility. Once 
you find the information you’re interested in, just print 
it out, paste it into another Windows application, or call 


CD-ROM! 



us and order it. 

The special 
introductory 
price for 
MegaGuide is 
only $9.95 per 
quarterly 
edition. Or get 
a year’s 

subscription for 
$29.95 and 
save 25%. To put 
this valuable 
information at your fingertips, 
call The Programmer’s Shop today! 


Special introductory 
price of $ 9 > 95 ! 


Give us a call at 1800-421-8006 

Mon.-Fri. 8:30-8:00 EST to place an order, get a copy of MegaGuide or The Programmer’s Shop 
Catalog, or for information. We look forward to hearing from you. 
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Table 1 8-bit equivalents for Boolean ROP functions 

Boolean function 

8-Bit Equivalent 

and(X,Y) 

min(X,Y) 

or(X,Y) 

max(X,Y) 

xor(X,Y) 

abs(X-Y) 

not(X) 

255 -X 


the ROP itself (B8). The Windows SDK gives RPN expres¬ 
sions for each ROP, but the expression given for B8 is 
PSDPxax. This Boolean equation is equivalent to the one 
given above (and, of course, the truth tables are identical), 
but it is not at all obvious that the Boolean expression 
PSDPxax is equivalent to the 'if/then' expression. The point 
is that if the 'if/then' expression given above is the de¬ 
sired result, there is really no way to tell which ROP imple¬ 
ments it other than writing out a truth table. The RPN 
equations in the SDK have been massaged so that, with a 
few exceptions, all the operands are on the left side of the 
equation and all the operators are on the right. This has 
several advantages, but helping you understand the intent 
of the ROP is not one of them. 

The upshot of all this is that some applications use 
ROPs experimentally. At HP, we trapped ROP calls over a 
test suite of documents using several common applica¬ 


tions, and found that the ROP B8 is typically used with a 
null or missing source so that 

if (S) return D 
else return P 

becomes 
return P 

In such cases, ROP B8 is equivalent to ROP FO, which is 
itself so popular it has what the SDK refers to as a com¬ 
mon name: PATCOPY. Ultimately, the decision to use a par¬ 
ticular ROP should be based on the desired result of the 
ROP. The easiest and most sensible way to find out which 
ROP does a particular operation is to fill out the result 
portion of a truth table, as shown above. More examples 
are given, as always, in Petzold. 

The 256 ROPs can be divided into three distinct catego¬ 
ries: 

• Trivial ROPs: 1 operand, and 0 or 1 operators. Exam¬ 
ples: PATCOPY, DSTINVERT 

• Simple ROPs: 2 operands, 1-3 operators. Examples: 
SRCPAINT, PATINVERT. 

• Complex ROPs: 3 or more operands, 2 or more opera¬ 
tors. Examples: PATPAINT, almost all unnamed ones. 

Usually you will find that the ROP you need is, by the 
above definition, trivial or simple. If you are using a com¬ 
plex ROP, ask yourself the following questions: 

• Do I understand why this ROP is 
being used? 

• Can I make a simplifying assump¬ 
tion about the inputs that would 
allow me to use a simpler ROP? 

• Have I used a truth table to verify 
that this ROP is the necessary 
one? 

This is not to say that you 
shouldn't use complex ROPs. On the 
contrary, in some cases a single 
BitBltO call with the appropriate 
ROP can perform an amazing 
amount of image processing. But this 
power can get you in trouble if you 
don't understand exactly what the 
ROP is doing to your bitmap. 

ROPs in the 8-Bit Realm 

As Figure 2 shows, the simplest 
way to perform a ROP on 8-bit oper¬ 
ands is to continue to use the 
Boolean operators with 8-bit oper¬ 
ands rather than 1-bit operands. In 
fact, this is a terrible way to imple¬ 
ment the ROP, but a few graphics 
driver writers have succumbed to its 
simplicity. The following example 
shows why this is not a good idea. 

Assume the ROP is SRCPAINT. The 
SDK gives the Boolean equation as 
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DSo, or equivalently, Destination OR Source. Suppose the 
source and destination are both 8-bit values and they specify 
a gray level from 0 (black) to 255 (white). First, consider a 
case where the source is equal to 128 (medium gray) and the 
destination is also equal to medium gray: 

Source 10000000 
Destination 1 0 0 0 0 0 0 0 


That seems reasonable, but look what happens if the 
source is 127 (a barely darker gray) and the destination is 
still 128: 


Source 0 1111111 
Destination 10000000 


Result 11111111 


Result 10000000 
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•Researches 2 billion words in one 
second—chains databases 

• Fast, sub-second response on 
word or phrase searches 

• Interfaces to over 30 popular 
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major word processors, ASCII, 
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•Very high level API 
•Automatically 

and transparently 
selects its own 
optimal retrieval 
strategy 
•Word, phrase, 

Boolean and 
proximity operators 
•Allows text access routines to 
be plugged into the bottom of 
the ISYS engine, providing full ISYS 
engine functionality for your own data 
sources, file formats—even distributed data 
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• Internally optimized, high-performance DLL 
•Wild cards and tense word stem searching 
•Searching within labelled paragraphs 
• Rule-based, or imperative-based, 
index building strategies 
•Progressive searching 
•Sounds-like searching 
•Very low disk overhead 
(typically 20-25% of 
original text size) 
• Designed for ease 
of use by the 
calling programmer 
•Searches up to 16 indexes 
at once—transparently 
•Builds an auxiliary index to 
the text in-situ—does not 
import text building strategies 
•Synonyms and dynamic synonyms 
• Ideal authoring software for CD-ROMs 
•Fast index building (typically 1 MB/minute) 
•Callable from C, Pascal, and even Visual Basic 
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The two cases seem almost identi¬ 
cal; the source and destination are 
both a medium shade of gray, with a 
difference of only one between the 
case 1 source and the case 2 source. 
But the results are drastically differ¬ 
ent! The first case yields a medium 
shade of gray, but the second case 
yields white, which is almost certainly 
not what the caller had in mind. This 
extreme sensitivity to initial condi¬ 
tions arises because the ROP oper¬ 
ates on the bits that represent the 
color, rather than on the value of the 
color - the colors 0x80 and 0x7F are 
very different when treated as a set 
of bits, but are very similar when 
treated as integers (127 and 128). The 
only reason ROPs are done this way at 
all is that for trivial ROPs (ROPs with 
only one operand and zero or one op¬ 
erators in the Boolean RPN equation) 
the result is reasonable. 

If using Boolean operators on 8- 
bit values yields results that are un¬ 
desirable, using the same Boolean 
operators on colors represented as 
color palette indices is downright lu¬ 
dicrous. In 8-bit indexed mode, each 
24-bit color in a 256-color palette is 
referred to by an 8-bit index. Per¬ 
forming ROPs on the binary repre¬ 
sentation of an 8-bit index basically 
results in a 'random' color, depend¬ 
ent on the binary representation of 
the index of the color and on the or¬ 
ganization of the color table itself. 
Don't do this! 

A Better Interpretation of 
Color ROPs 

Since the monochrome definition 
of ROPs is not very useful when deal¬ 
ing with color, it is worth considering 
whether there is an interpretation of 
ROPs that makes sense for 24-bit 
color bitmaps. As mentioned earlier, 
the SDK listing of ROPs also gives for 
each ROP an equivalent RPN Boolean 
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40 
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61 
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equation, using the following 4 operators: o (OR), a (AND), 
x (XOR), and n (NOT). Finding a useful meaning for ROPs 
when dealing with color involves assigning new meanings 
to these functions. 

To implement a meaningful ROP for color, 1 use the 
function equivalents shown in Table 1. The table assumes 
an 8-bit input; if you are using 24-bit color, you would just 
apply the operation separately to each of the three color 
values. To understand why I selected these particular 8-bit 
function equivalents, consider the MIN, MAX, and ABS 
functions applied to 1-bit operands. In the 1-bit realm, 
AND(X,Y) has the same truth table as min(x,y), and OR(X,Y) 
is the same as max(X,Y). XOR(X,Y) is perhaps most clearly 
thought of as the difference between AND and OR, just as 
it is in the Boolean realm. The NOT operator is a bit differ¬ 
ent. There are two reasons to apply the NOT operator to 
a color: to invert it, or to generate a color that has maxi¬ 
mal contrast with the original. The function equivalent for 
NOT in Table 1 performs an inversion, but does not yield 
maximal contrast. Nevertheless, for most uses of NOT, it is 
superior to a function such as (X+128) % 255, which gives 
uniformly good contrast. 

As I mentioned earlier, one of the advantages of XOR is 
that it can be used to quickly move objects around on the 
screen: XOR it once and it's there, XOR it again and the orig- 
nal re-appears. The new interpretation of XOR preserves that 
property - but there are properties of XOR that are present in 
the Boolean realm that are not preserved using my func¬ 
tional equivalent of XOR in 8-bit mode (actually, the only 
way that all Boolean properties of XOR can be preserved in 
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Listing 1 dorop.c — 8-bit color ternary ROP 
implementation 


typedef unsigned char UBYTE; 

// EquationList holds the RPN ROP equation. These are right out of the SDK. 
// Programmer's Reference Vol. 3. Appendix A. 
static char Equationlist[][12]= 


{"0 

"DPSoon", 

"DPSona", 

"PSon", 

"SDPona", 

"DPon", 

"PDSxnon", 

"PDSaon", 

"SDPnaa", 

"PDSxon", 

"DPna", 

"PSDnaon", 

"SPna", 

"PDSnaon", 

"PDSonon", 

"Pn". 

"PDSona", 

"DSon", 

"SDPxnon", 

"SDPaon", 

"DPSxnon", 

"DPSaon", 

"PSDPSanaxx", 

"SSPxDSxaxn", 

"SPxPDxa", 

"SDPSanaxn", 

"PDSPaox", 

"SDPSxaxn", 

"PSDPaox", 

"DSPDxaxn", 

"PDSox". 

"PDSoan", 

"DPSnaa", 

"SDPxon", 

"DSna", 

"SPDnaon", 

"SPxDSxa", 

"PDSPanaxn", 

"SDPSaox", 

"SDPSxnox", 

"DPSxa", 

"PSDPSaoxxn", 

"DPSana", 

"SSPxPDxaxn", 

"SPDSoax", 

"PSDnox", 

"PSDPxox", 

"PSDnoan", 

"PSna", 

"SDPnaorf. 

"SDPSoox", 

"Sn". 

"SPDSaox". 

"SPDSxnox", 

"SDPox", 

"SDPoan", 

"PSDPoax", 

"SPDnox", 

"SPDSxox", 

"SPDnoan", 

"PSx", 

"SPDSonox", 

"SPDSnaox", 

"PSan", 

"PSDnaa", 

"DPSxon", 

"SDxPDxa", 

"SPDSanaxn", 

"SDna", 

"DPSnaon", 

"DSPDaox", 

"PSDPxaxn", 

"SDPxa", 

"PDSPDaoxxn", 

"DPSDoax", 

"PDSnox", 

"SDPana", 

"SSPxDSxoxn", 

"PDSPxox", 

"PDSnoan" 

"PDna", 

"DSPnaon", 

"DPSDaox", 

"SPDSxaxn", 

"DPSonon", 

"Dn". 

"DPSox", 

"DPSoan", 

"PDSPoax", 

"DPSnox", 

"DPx", 

"DPSDonox", 

"DPSDxox", 

"DPSnoan", 

"DPSDnaox", 

"DPan", 

"PDSxa", 

"DSPDSaoxxn", 

"DSPDoax", 

"SDPnox", 

"SDPSoax", 

"DSPnox", 

"DSx", 

"SDPSonox", 

"DSPDSonoxxn" 

."PDSxxn", 

"DPSax", 

"PSDPSoaxxn", 
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Phone:(613)825-6271 ■ 

FAX: 613-825-5521 ■ 

CompuServe: 72060,3056 ■ ■ 


O Request Reader Service #217/FAX #1077 □ 

Windows/DOS Developer’s Journal — Page 19 


October 1994 






















"SDPax", 

"PDSPDoaxxn", 

"SDPSnoax". 

"PDSxnan", 

"PDSana", 

"SSDxPDxaxn", 

"SDPSxox", 

"SDPnoan", 

"DSPDxox", 

"DSPnoan", 

"SDPSnaox". 

"DSan", 

"PDSax", 

"DSPDSoaxxn", 

"DPSDnoax". 

"SDPxnan", 

"SPDSnoax", 

"DPSxnan", 

"SPxDSxo", 

"DPSaan"}; 


// Rops 128-255 are just like Rops 0-127, NOTed. The indexing is like so: 

// IF (R0P>127) EquationLlst(ROP) = NOT(EquationList(255-R0P)) 

// EquationListLength Is the length in characters of the RPN boolean equation 

// that corresponds to the ROP. 

static UBYTE EquationlistLength[]={l,6.6,4.6.4,7,6, 

6.6.4.7.4.7.7.2. 

6.4.7.6.7.6.10.10. 

7.9.7.8.7.8.5.6. 

6. 6.4. 7.7.9.7.8. 

5.10.6.10.7.6.7.7. 

4.7.7.2.7.8.5.6. 

7.6.7.7.3.8.8.4. 

6. 6.7.9.4, 7.7.8. 

5.10.7.6.6.10.7.7. 

4.7.7.8.7.2.5.6. 

7.6.3.8.7.7.8.4. 

5,10.7, 6.7. 6,3,8, 

11. 6.5,10.5.10.8.7. 

6.10.7.7.7.7.8.4. 

5,10.8.7.8.7,7.6}; 


/* DoRop */ 
/* */ 
/* DoRop is passed three bytes, one each from the current source. */ 
/* destination, and pattern, and a ROP to use to combine the bytes. The */ 
/* result of the ROP is returned. */ 
/* */ 
/* If this function is to be used with 24 bit values, it needs to be called */ 


/* for each of the 3 color planes, then the results of the 3 calls are 
/* combined. 


*/ 

*/ 


/*****************************************************************************/ 


UBYTE DoRop(UBYTE src, 
UBYTE dest, 

UBYTE pat. 

UBYTE rop3) 

// The 8 bit value of the source 
// The 8 bit value of the destination 
// The 8 bit value of the brush 
// The ROP to use 

{ 

UBYTE Stack[7]; 

// Array used as a stack for calculating the RPN 
// equation stored in EquationList that calculates 
// the ROP. 

short StackPointer; 

// Current position in the stack 

UBYTE a.b; 

// Used to hold temporary results when executing 
// an operator off the stack. 

UBYTE 1; 

// Loops over the RPN equation corresponding to the 
// ROP 

UBYTE Rop3Index; 

// Used to index into EquationList. EquationList 
// has 128 ROPs in it. not the full 256. We take 
// advantage of the fact that ROPs 128-256 are the 
// same as ROPs 0-127, negated. 

short EquationLength; // Copy of equation length of current ROP 

UBYTE Equation[12]; // Copy of RPN equation for current ROP 

StackPointer = 0; 

// Initialize stack pointer 


// Get length and boolean equation code from rop. 

// if ROP is 0-127, load it. 

// if ROP is 128-255, load 255-ROP. 

Rop3Index = (rop3 > 127) ? 255-rop3 : rop3; // Get index for arrays 
EquationLength = EquationListLength[Rop3Index]; // Get ROP equation len. 


for (i=0; i< EquationLength; i++) 

{ 

EquationLi] = EquationList[Rop3Index][i]; 

} 


// Make a local copy of 
// the RPN ROP equation. 


If (rop3 > 127) // If the ROP Is > 127, we need to negate it. 
{ 


8-bit mode is to continue to use a Boolean XOR, and I've 
already discussed why that isnt a good idea). 

Perhaps the most useful property of Boolean XOR that 
gets broken in 8-bit mode is the following: 

X A (NOT X) = 1 

In English: X XOR-ed with its opposite yields white. This 
can be used by a ROP that uses an XOR operator to make 
a certain part of the image "disappear" by XORing these 
regions with their opposite. In fact, I have seen some 
drawing applications do this, albeit very infrequently. So, 
one could argue that XOR should be implemented as a 
Boolean function, since its primary purpose is to mask and 
unmask regions of a bitmap. I think functional smooth¬ 
ness is more important, but the argument could be made. 

An example can help give you a feel for the visual 
meaning of these operators. Earlier I showed that the ROP 
B8 has the equivalent Boolean RPN equation of PSDPxax, 
given in the SDK. If you convert the operators using the 
correspondences in Table 1 and undo the postfix notation, 
you get the following expression: 

abs(P - min(S, abs(D-P))) 

Suppose D=0, P=255, and S=0. Then using the if/then 
form of this ROP that I derived previously: 

IF (S) return D 
ELSE return P 

you might reasonably expect a result value equal to P, 
since S is 'off'. Substituting in the current values for S, D, 
and P you get: 

abs(255 - min(0, abs(0-255))) = 255 

the current value of P, as advertised. Now, if S were equal 
to 255 the result would be: 

abs(255 - min(255, abs(0-255))) = 0 

and zero is the current value of D. 

So far, so good. This equation seems to mimic the ef¬ 
fects of the Boolean expression when used with argu¬ 
ments that are more-or-less binary: 0 (off) or 255 (on). But 
now you've got eight bits for each argument: things are 
no longer black and white, they are quite literally shades 
of gray. If S is an intermediate value, the desired result 
should be somewhere between the values of D and P. If D is 
still zero and P is still 255, but S is equal to 127, you get: 

abs(255 - min(127, abs(0-255))) = 128 

halfway between D and P. This is a reasonable thing to 
expect, since the source is 'half on'. 

Having laid the groundwork with this explanation of 
how I chose these particular 8-bit equivalents to binary 
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operators, I now turn to more interesting things, such as 
implementing all 256 ROPs easily. 

Implementing ROPs in C with 8-Bit Operands 

There are several different approaches to writing code 
to implement the proposed interpretation of ternary ROPs. 
Sometimes the caller will be working in 8 bits per pixel 
mode, as in the previous examples. More common might 
be 24 bits per pixel (8 bits for each color: red, green, and 
blue), in which case you could perform the ROP on each 
color plane independently. The remainder of this discus¬ 
sion focuses on the 8 bits per pixel case. Callers who need 
to use 24 bits per pixel can either call the ROP function 
three times, once per color plane, or modify the code to 
pass in a 24-bit value, then break it apart into three 8-bit 
chunks before doing the ROPs. 

One way to implement the ROPs would be to have 256 
individual functions, one for each ROP. This is not too unrea¬ 
sonable, since each function is quite short. For example, ROP 
11 is called NOTSRCERASE and has the Boolean RPN equa¬ 
tion of DSon; you could translate this to an infix expres¬ 
sion and replace the OR and NOT operators with their 
equivalents from Table 1 to produce: 

255 - max(D,$) 

Given this formula, you could implement it with the fol¬ 
lowing function: 

byte RopB8(byte Source, byte Dest, byte Pattern) { 
return -((Dest > Source) 

? Dest : Source); 

} 

Note that I used the - operator here to produce the same 
effect as subtracting from 255. 

Another example would be a function for the ROP CO, 
which has the common name of MERGECOPY. The SDK says 
that the Boolean RPN expression for this ROP is PSa, so 
you can write a function to implement it as follows: 

byte RopC0(byte Source, byte Dest, byte Pattern) { 
return (Pattern > Source) 

? Source : Pattern; 

} 

For a more complicated example, here's a function that 
implements the B8 ROP discussed above. This could be 
implemented as a single return statement with nested 
macro expansions or complicated if/then logic, but it 
would be more easily understood like this: 

(/define ABS(x) (<x>=0)?x:-x) 

byte RopB8(byte Source, byte Dest, byte Pattern) { 

/* ROP B8 is PSDPxax */ 
byte temp; 

/* do first XOR operator */ 
temp = (Dest > Pattern) ? 


Listing 1 continued 

if (EquationCEquationLength-1] == 

'n') // If the equation happens 

< 

// to end with a NOT operator, 

EquationLength--; 

// remove it by shortening the 

i 

// equation length. 

else 

// If the equation does not end 

t 

// with a NOT operator, add one. 

Equation[Equationlength++] = 

} 

n'; 

for (i=0; i<EquationLength; i++) 

{ 

// Loop over equation 

if (Equation[i] == 'D') 

// If Destination, 

< 

// put current destination 

Stack[StackPointer++] = dest; 

} 

// value on the stack. 

else if (Equation[i] == 'S') 

// If Source, 

t 

// put current source value 

Stack[StackPointer++] = src 

} 

// on the stack 

else if (Equation^] == T) 

// If pattern. 

( 

// put current pattern value on 

Stack[StackPointem] = pat; 

} 

// the stack. 

else if (Equation[i] == '0') 

// If zero, put zero on the 

t 

// stack. This will only happen 

Stack[StackPointer++] = 0; 

// with ROPs WHITENESS and 

i 

// BLACKNESS. 

else if (Equation[i ] == 'a') 

// AND operator. 

StackPointer--; 

// Pop stack twice into local 

a = Stack[StackPointer]; 

// variables, and push the 

b = Stack[StackPointer-l]; 

// smaller one back on the stack 

StackCStackPointer-1] = (a < b) ? a : b; 
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Listing 1 continued 

} 

else If (Equation[1 ] == 'n') 

// NOT operator. Flip the bits 

( 

// of the top of the stack. 

Stack[$tackPointer-l] = (UBYTE)255 - Stack[StackPointer-1]; 

} 

else if (Equation[1] == 'o') 

// OR operator. 

StackPointei—; 

// Pop stack twice into local 

a = Stack[StackPointer]; 

// variables, and push the 

b = Stack[StackPointer-l]; 

// larger one back on the stack 

Stack[StackPointer-l] = (a < b) 

} 

? b : a: 

else if (Equation[i] == 'x') 

// XOR operator. 

StackPointer--; 

// Pop stack twice into local 

a = StackfStackPointer]: 

// variables, and push the ABS 

b * StackCStackPolnter-13: 

// of the difference back on the 


// stack. 

Stack[StackPointer-l] = (a < b) 

} 

? b-a : a-b; 

} // next i 


return Stack[0]; 

// Top of stack now holds the 


(Dest-Pattern) : (Pattern-Dest); 
/* do AND operator */ 
if(Source<temp) temp = Source; 

/* do final XOR operator */ 
return (Pattern > temp) ? 

(Pattern-temp) : (temp-Pattern); 
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You could use macros instead of functions for in¬ 
creased speed. I've done three of the functions for you, so 
you only have 253 to go! One quick caveat on macros: it 
is quite easy to write one-line macros for the four opera¬ 
tors AND, OR, XOR, and NOT. it is also easy to write out a 
line of C code that uses these macros to calculate any 
ROP. However, the complicated ROPs (such as B8) will 
have a fair amount of nesting, which will adversely affect 
performance when compared with a simpler implementation. 

Another option that may be more attractive is to spe¬ 
cial-case a few common ROPs with individual functions or 
macros, and send all the others to a function that will 
handle any ROP. This approach allows performance tun¬ 
ing of popular ROPs without requiring tuning of all 256 of 
them. DoRopO in dorop.c (Listing 1) is a function that cor¬ 
rectly calculates and returns the 8-bit result for any of the 
ROPs, given any source, pattern, and destination bytes. 

The key to dorop.c is that the Boolean RPN equation 
for each ROP is stored in a static character array outside 
the function itself. When a ROP is passed in to DoRopO, it 
looks up the appropriate Boolean equation and executes 
it. These equations are easy to execute: all you need is a 
short stack (the maximum stack depth of the 256 ternary 
ROPs is 5) and the ability to perform the 8-bit equivalents 
to the Boolean functions, as discussed above. 

You may notice that I use only 128 hardcoded ROP 
equations to support the 256 ROPs. This is because ROPs 
128-255 are the inverses of ROPs 0-127, so if DoRopO is 
passed a ROP number over 128, I add or subtract a NOT 
operand from a lower-numbered ROP code to get the 
equation I really want. 

You can also use DoRopO to handle binary ROPs. Binary 
ROPs specify a Boolean combination of destination and 
pen, and are best implemented as a subset of ternary 
ROPs, namely, the ones that do not involve the source. 
The sixteen binary ROPs have the following ternary ROP 
codes: 00, 05, OA, OF, 50, 55, 5A, 5F, AO, A5, AA, AF, FO, 
F5, FA, FF. Since these 16 ROPs don't involve the source 
byte, a zero or even unassigned value can be passed with 
no ill effects. 

Wrapping It All Up 

Using a combination of specialized functions and gen¬ 
eral purpose functions such as DoRopO, any of the 256 
possible ROPs can be reasonably implemented in 8-bit 
mode. The only remaining question is the same one ad¬ 
dressed above for the 1-bit case: If you know what you 
want to accomplish, how do you decide which ROP to 
use? Unfortunately, you can't really go back to writing out 
a truth table, since the result field would have to have 2 24 
entries (of which only 256 would really exist since there 
are only 256 ROPs). If the desired result is simple enough, 
involving two (or less) of the three inputs to the ROP func¬ 
tion, it is possible that the ROP may be found by inspec¬ 
tion. If not, or if the ROP involves all three of the inputs, 
the best advice is to figure out what you would want the 
ROP to do if the inputs were 1 bit per pixel per plane, 
then use the truth table technique shown above to find 
the particular ROP that you need. □ 
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WinG: 

Faster Graphics for Windows 

Ron Burk 


At Software Development '94, Microsoft informally demonstrated a new 
graphics DLL called WinG. As of this writing, WinG is available for beta testing 
(download just4u.zip from the WINMM forum of CompuServe). This article 
gives you enough information to decide whether or not you should be inter¬ 
ested in WinG for your own applications. 

Bitmaps 

To understand WinG, you have to understand Windows bitmaps. Bitmaps 
are the fundamental unit of Windows graphics, especially anything having to 
do with animation and multimedia. In the old days, Windows just had plain old 
bitmaps. Old-style bitmaps (the kind you pass to BitBltO) can be fast (if the 
display device driver writer does a good job) because they are laid out in mem¬ 
ory to be compatible with the destination graphics adapter. For example, if the 
graphics adapter uses color planes, then the device dependent bitmap will 
store the color planes for each scan line sequentially. On a different device, the 
same bitmap might be stored as one byte per pixel, where each byte specifies 
one of 256 colors. 


Ron Burk is the editor of Windows/DOS Developer's Journal and has been a program¬ 
mer for 12 years. You may contact him at Burk Labs, P.O. Box 3082, Redmond, WA 
98073-3082. CIS: 70302,2566. Internet: ronb@rdpub.com (" . . . luunetlrdpublronb"). 
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Although they can be fast, the problem with device-de¬ 
pendent bitmaps is that they are device-dependent. If you 
are writing games, animation, or multimedia applications, 
you want to create bitmaps once and have them appear 
roughly similarly on any display adapter that the end user 
uses. Windows 2.0 addressed this problem by introducing 
the Device-Independent Bitmap (DIB). 

A DIB consists of two parts: a color table that specifies 
precisely (in 24-bit color) what colors the bitmap was in¬ 
tended to use, and the bitmap itself. By using DIBs, you 
can create a bitmap once and ensure that at runtime it 
will be drawn with the same colors (or as close as possi¬ 
ble), no matter what graphics adapter the user is using. 
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When using DIBs, you don't end up calling BitBltO to 
move bitmaps to the screen. Instead, you call StretchDI- 
BitsO or SetDIBitsToDeviceO. The problem then becomes 
this: StretchDIBitsO is darn slow compared to BitBltO. 
The penalty for device independence is loss of speed, and 
it has been enough of a penalty that few DOS game de¬ 
velopers have moved to Windows. 

Here Comes WinG 

it is somewhat of a simplification, but I can sum up 
WinG like this: it makes StretchDIBitsO go as fast as 
BitBltO. More precisely, it gives you a new kind of device 
context, called a WinGDC. You can draw on this device 
context with normal GDI functions, 
but you can also obtain a pointer to 
the underlying bitmap and directly 
modify it with your own custom rou¬ 
tines for maximal speed. WinG gives 
you a function, MinGBitBltO, that will 
copy the WinGDC to the screen at 
speeds commensurate with what 
BitBltO delivers for device-depend¬ 
ent bitmaps. 

Note that I said you can obtain a 
pointer to the underlying bitmap that 
the WinGDC represents. Why would 
you want to do this if you can draw 
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on the bitmap with normal GDI functions like LineToO ? 
The answer is speed. You will almost always be able to 
beat GDI with your own custom, high-speed drawing rou¬ 
tines. Games programmers probably already have their 
own library of 32-bit assembler functions for manipulating 
bitmaps, and WinG gives them the direct access they need 
so they can keep their routines and not be slowed down 
by GDI. 

The basic scheme for high-speed, device-independent 
graphics with WinG goes something like this: you create a 
WinGDC once when your program starts up. You call UinG- 
CreateBitmapO to create a device-independent bitmap the 
same size as the destination window, to select into the 
WinGDC. You then draw on the WinGDC with GDI, your 
own custom routines, or both. Everytime you want the 
screen to reflect your in-memory changes, you call UinG- 
BitBltO to blast them to the screen. 

Does it work? Microsoft's favorite WinG demo is a ver¬ 
sion of Doom running in a Windows window. If Doom 
successfully ports to Windows, you can bet a lot of for¬ 
merly DOS-only graphics games will follow. 

Who Cares? 

Microsoft doesn't create systems software without a fi¬ 
nancial motivation, so why are they investing all this ef¬ 
fort to speed up graphics under Windows and attract DOS 
game developers to Windows? There are a couple of 
trends that can explain this. First, believe it or not, sales of 
Pentium machines are being driven right now by home 
buyers, not by businesses. Some theorize that this is be¬ 
cause home use involves applications (games, multimedia) 
that benefit more noticeably from faster hardware than 
does the average business application (spreadsheets, word 
processors). 

That theory is bolstered by a second trend: the number 
one use that home computers are being put to right now 
is entertainment. Some years back, the main use was to 
do office work at home, but entertainment has now pulled 
well ahead of working at home. 

If you are doing games development, you definitely 
want to check out WinG. If you are doing lots of bit¬ 
mapped graphics under Windows 3.1 and DIBs are 
slowing you down, then you too want to grab WinG. 
WinG is supposed to come with both Chicago and NT, 
in addition to being available as distributable software 
for Windows 3.1. □ 
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Bug++ of the Month 

Mark Nelson 


Advocates of structured programming frequently stress 
that it is desirable to have only a single exit point from a 
given function or procedure. This is supposed to make a 
function easier to understand, and hence easier to main¬ 
tain. If there is only one way out of a function, theory 
says you are more likely to clean up after yourself prop¬ 
erly on the way out. 

C and C++ programmers routinely violate this rule of 
thumb by liberal use of the return keyword. Being able to 
return from the middle of a function may be the func¬ 
tional equivalent of using the forbidden goto, but I don't 
expect to see its use disappear any time soon. Multiple 
returns are a convenience that C programmers won't give 
up without a fight. 

Unfortunately, multiple exit points also seem to give 
C++ compiler writers a bit of trouble. When a C++ func¬ 
tion exits, the compiler needs to generate calls to the de¬ 
structors of any automatic objects that were created in the 
body of the function. This is complicated by the fact that 
objects may be created anywhere in the function. Poten¬ 
tially, then, the compiler would have to generate a differ¬ 
ent set of destructor calls for each exit from a function. 

bug004.cpp (Listing 1) shows how this month's bug 
tripped up the designers of Watcom's C++ compiler, ver¬ 
sion 10.0. The heart of the problem shown here is the 
function test(). testO has a switch statement that creates 
several different exit points from the function. Before the 
switch statement is invoked, testO creates an automatic 
instance of an object of class TestObj. If the compiler were 


working properly, the TestObj destructor would be called 
when any of the four possible return statements are in¬ 
voked. Unfortunately, this doesn't happen. 

In order to track the calls to the constructor and de¬ 
structor for class TestObj, I wrote code to display a brief 
diagnostic message when each is called. Each time func¬ 
tion testO is called, you should see an output sequence 
similar to this: 

Calling test with arg = x 
Creating TestObj, value = x 
Destroying TestObj, value = x 

But after making four consecutive calls to testO, code 
generated by Watcom 10.0 produces the following output: 

Calling test with arg = 1 
Creating TestObj, value = 1 
Destroying TestObj, value = 1 

Calling test with arg = 2 
Creating TestObj, value = 2 

Calling test with arg = 3 
Creating TestObj, value = 3 

Calling test with arg = 4 
Creating TestObj, value = 4 
Destroying TestObj. value = 4 


Mark Nelson is a programmer for Greenleaf Software and a student at the University of Texas at Dallas. Mark is the author of The 
Data Compression Book and Serial Communications: A C++ Developer's Guide, both from MOT Books. You can reach Mark 
on CompuServe at 73650,312. 
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Apparently only two out of four paths through testO 
have the correct calls to both the constructor and the de¬ 
structor! 

Failure to call the destructor for an automatic object 
can be a tough bug to find. Debugging tools such as 
MemCheck or Bounds Checker won't detect these prob¬ 
lems, since automatic storage is always freed when a 
function returns. Instead, you have to look for other miss¬ 
ing side effects. If your destructor has duties such as clos¬ 
ing files, flushing buffers, or freeing data structures, you 
may spend a lot of time analyzing your code before stum¬ 
bling on the real problem. 

Watcom's Response 

Finding bugs in compilers is an annoyance that can be 
greatly magnified by an unresponsive vendor or tech sup¬ 
port department. I particularly dislike spending hours or 
days characterizing a compiler problem, only to have my 
bug report disappear into a black hole, with apparent in¬ 
difference on the part of the support team. 

Watcom's response from Deanne Farrar was a refresh¬ 
ing change: 

Thanks for the C++ bug report. The problem will be fixed 

in the A-level patches. I can send you an early version of 

the A-level compiler if you are interested. 

Watcom regularly publishes compiler patches on its Com¬ 
puServe forum (GO POWERSOFT, Section 15) and its BBS 
(1-519-884-2103). In my experience, they are very good 
about acknowledging bugs and providing fixes in a timely 
manner. Some people don't like having to download and 
apply patches, viewing it as a waste of their time. How- 
ever, I would much rather download a few patch files 
than wait months, or even years, for the next major re¬ 
lease of a product. 

The Moral 

There are a few important lessons to be learned from 
this bug. First, if your destructor doesn't seem to be work¬ 
ing properly, always check to be sure it is being called! 
We all lose track of dynamic objects from time to time, 
the result being easy-to-find memory leaks. But we nor¬ 
mally take it for granted that automatic objects are being 
destroyed properly. A simple set of diagnostic printouts 
such as I used here can highlight missing destructors 
quickly, regardless of where the blame lies. Ron Burk has 
even suggested the creation of a global base class that 
does nothing more than perform bookkeeping on con¬ 
structor and destructor calls. 

Second, regardless of whose compiler you are using, be 
sure to check their electronic support forums for patches. 
You may save yourself a few late night sessions with the 
debugger by simply bringing your executables up to date. 
And it helps you fend off the inevitable first question from 
Tech Support: 'Have you applied all of the published 
patches?' 

Finally, be sure to keep your vendor informed. If you 
get on Watcom's CompuServe forum and report a legiti¬ 


mate bug, your chances of seeing it fixed seem to be 
pretty good. You'll be helping yourself, Watcom, and other 
Watcom users at the same time. Getting credit for a ran¬ 
dom act of kindness towards a compiler vendor might not 
qualify you for the ACM Turing Award, but you might 
score some points with your fellow users. □ 


Listing 1 bugoo4.cpp 


^include <iostream.h> 

class TestObj { 
public : 
int value; 

TestObj( int a ); 

-TestObj(); 

}; 

TestObj::TestObj( int a ) 

{ 

value = a; 

cout « "Creating TestObj, value = " 

« value 
« "\n"; 

} 

TestObj:;-TestObj () 

{ 

cout « "Destroying TestObj, value = " 

« value 
« "\n"; 

) 

int test( int which ) 

{ 

cout « "\nCalling test with arg = " « which « "\n"; 

TestObj foot which ); 
switch ( which ) { 
case 1 : return 1; 
case 2 : return 2; 
case 3 : return 3; 

} 

return -1; 

} 

maint) 

{ 

testt 1 ); 
testt 2 ); 
testt 3 ); 
return testt 4 ); 

) 

// End of File 
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■ Windows Questions & Answers 



Paul Bonneau 


Send questions to Paul via Internet as 
paulPrdpub.com 
from CompuServe: 

>INTERNET:paulPrdpub.com 
or in care of this magazine at: 

1601 W. 23rd St., Suite 200 
Lawrence, KS 66046-2700. 

Paul answers all electronic 
communications but is unable to 
respond personally to hard copy/disk 
messages. 
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Q l'm porting a MIDI sequencer program originally written for the ATARI ST 
computer to Windows. Windows 3.1 has a new feature called MultiMedia 
Extensions (MME) which has a lot of routines for dealing with MIDI, timers, etc. 
The heart of a sequencer program is the interrupt-driven timer routine. In 
Windows this routine is placed in a DLL with fixed and nondiscardable seg¬ 
ment attributes. See Figure 1 for the way it is done. 

Most of the time the timer routine will do nothing more than increment 
some counter, but at some point it will trigger a lot of events. This may take a 
lot of time. It will probably now and then take more than 2 milliseconds (our 
timer's resolution). This means that we want the timer to be able to interrupt 
itself so that its frequency does not decrease. However, the callback function 
set up by timeSetEventO seems to disable all interrupts as long as it is 
executing. So my question is: How can I allow the timer routine to interrupt 
itself? This is what I want to do (see Figure 2). 

I want to use a semaphore that allows the timer routine itself to be 
interrupted. When the timer tick occurs, the semaphore is incremented and 
timer interrupts are re-enabled. If the semaphore has been incremented to 1, 
no interrupts are nested and normal processing can resume. If the value is 
greater than 1, this means that the timer interrupts have been stacked up, so 
the interrupt routine exits and returns control to the timer routine that was 
interrupted. Before the timer routine exits, the semaphore is decremented, and 
if the value is still nonzero, the interrupts must have been nested. In this case 
control is returned to the top of the timer routine, which loops until the 
semaphore returns to zero. This allows the timer routine to catch up with lost 
interrupts without losing any timer pulses. 

This is the way I have done it on the ATARI and the way I would like to do 
it in the Windows version. The idea is from an article by Marc Garvin in Dr. 
Dobb's Journal, May 1987. The November '93 issue of Windows/DOS Developer's 
Journal has an article by Mark Szamrej that deals with high resolution timers. 
But this problem is never mentioned. Responsibility for timer handling under 
Windows seems to be assigned to something called the Virtual Timer Device 
(VTD). This should be documented in the Device Driver Development Kit (DDK), 
which I unfortunately do not have access to. Maybe this is the solution. 

Rolf Nilsson 
SWEDEN 

A Both ToolHelp and the multimedia timer services rely on a Windows VxD 
called VTDAPI to provide the low-level support for high-resolution timers. I 
spoke to Glen Slick, a developer in Microsoft's Developer Support Group (and in 
my opinion the most knowledgeable source for hard-core VxD know-how), 
about VTDAPI. VTDAPI's support is in the form of a protected-mode API that 


Paul was a developer of HyperChem, a molecular modeling system, and more recently, 
of Creative Writer, a word processor for children. He works for Microsoft Corporation as 
a Software Design Engineer. The opinions expressed in this column are Paul's alone 
and not those of Microsoft. 
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Windows executables and DLLs can call. One of the serv¬ 
ices of this API allows a caller to supply the address of a 
function that VTDAPI will call when the requested time 
period expires. VDTAPI supports up to eight such callbacks 
at any given time. 

It turns out that VTDAPI is purposefully preventing 
nested interrupts. The VxD maintains a semaphore per cli¬ 
ent. If a timer goes off while a notification is pending for a 
particular client's callback, VTDAPI ignores the second 
timer event. However, since there is a semaphore for each 
of the eight client callbacks, you may be able to register 
your callback twice (two calls to timeSetEventO). But I ad¬ 
vise against it. It incurs extra overhead (the transition from 
a VxD running in ring 0 to your Windows code running in 
ring 3 is expensive) and requires you to write extra logic 
to discern which calls your callback should ignore. 

All is not lost, however. It is possible to restructure your 
timer callback using the timeGetTimeO multimedia function. 
This returns the number of milliseconds that have elapsed 
since the Windows session was started. Instead of incre¬ 
menting the semaphore on a re-entrant call to your timer 
callback, you can obtain the current time when the call¬ 
back is entered and perform your processing inside a 
do/while loop. The condition to continue looping is if the 
current time minus the last measured time is greater than 
the timeout. 

This solution is only a little worse (in terms of execu¬ 
tion time) than what you were originally trying to do. The 
overhead of a call to your timer callback is about equiva¬ 
lent to the overhead of obtaining the current time. Both 
involve a ring transition. In the former case from ring 0 to 
ring 3, and in the latter from ring 3 to ring 0. I say a little 
worse because you will have to call timeGetTimeO at least 
twice from the revised callback, which means one more 
ring transition than in your original approach, timer.c( List¬ 
ing 1) contains a revised version of your timer callback. 

Q I am learning Windows and have what must be a 
common question. After searching through the 
W/DDJ index unsuccessfully I am writing you. The ques¬ 
tion concerns coordinating the behavior of my code with 
Windows messages which it generates. Specifically, my 
code is handling one Windows message and finds (in a 
deeply nested level) that it cannot process the messages 
any further until a Windows message which it generates 
(such as UM_PA I NT via InvalidateRectO) has been processed. 
But in order for the new message to be processed, the 
code needs to finish its current processing and return to 
Windows. This is a bit of a catch-22. One approach might 
be to determine early on if the first message can be proc¬ 
essed. If not, save it locally along with the new message it 
is waiting for, generate the new message, return to Win¬ 


dows, and after processing the new message, see that an 
old message is waiting for it and then process it. Is this 
the type of convoluted coding I should be prepared for 
when writing for Windows? 

Peter Wlodarski 
Deerfield, IL 

A rm not quite sure what you're asking, but I'll take my 
best shot. It sounds like your problem may stem from 
a misunderstanding of the behavior of the Invali¬ 
dateRectO API function. This function does not immedi¬ 
ately generate any messages - it behaves more like Post- 
MessageO. It is not until control returns to your message 
loop that a UM_PAINT message will be extracted from the 
message queue and then sent to your window (via Dis- 
patchMessageO). However, you can force the UM_PAINT to be 
sent if you follow the call to InvalidateRectO with a call to 
UpdateUindouO. This bypasses posting the message to the 
queue and causes Windows to immediately send a 
UM_PAINT to the window. 

Another thing to keep in mind is that you need to 
structure your application such that it can render its dis¬ 
play any time a UM_PAINT is received. One pitfall new pro¬ 
grammers sometimes fall into is the belief that they can 
rely on the state of the currently displayed image. The 
problem with this is that your window may be partly or 
wholly obscured by another window, yet still receive 
UMJAINT messages. If you need to rely on the state of the 
image, you might consider maintaining an offscreen bit¬ 
map. Then when your window receives a UM_PAINT, it can 
BitBltO from the offscreen bitmap to its client area. 

Q What is the relationship between UM_ERASEBKGND and 
UM_CTLC0L0R for a control that is not in a dialog box? I 
want to be able to change the background and fore¬ 
ground colors of these controls. Specifically, if I paint the 
background in UM_ERASEBKGND, why do I have to provide a 
brush in WM_CTLC0L0R? I don't want to be painting the same 
region twice. 

Thanks, 

Neil Galarneau 
neil@progress.com 

A There are several pieces to the puzzle. The 
h/M_ERASEBKGND message is sent by USER (the Windows 
module that contains most of its user interface code) to a 
window when USER determines that some portion (per¬ 
haps ail) of the window needs repainting. The first step in 
this process is to tell the window, via the klM_ERASEBKGND 
message, to erase its current contents. The device context 
supplied with the message has already been clipped to 
the area in need of painting. You can find the minimum 




bounding rectangle of this region (strictly speaking, the re¬ 
gion does not have to be rectangular) using the Windows 
API function GetClipBoxO. 

Some programs do not bother with handling this mes¬ 
sage. If your window always repaints its entire client area 
when it receives a NMJAINT (rather than trying to only re¬ 
paint the areas that are dirty), then it does not need to 
process the NMJRASEBKGND message. Windows will never 
send a window a NMJRASEBKGND without sending a sub¬ 
sequent NMJAINT for the same region. The NMJRASEBKGND 
message allows windows that do not paint their entire cli¬ 
ent area to refresh those portions not handled by their 
NM PAINT code. 
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for C/C++ 

presents Bug # 525 


int 

f( int x, int y 
t 

if( x > = 0 ) 

int z ) 


if < y > o 

z = 1; 


else if( y > 0 

z = 2; 


return z; 



j 


int 

main() 

{ 

printf( "%>d\n", 
return 0; 

} 

f< -1, 2, 0 ) ); 


The programmer feels that the arguments to f () are such that the value 2 should 
he printed. Instead. 0 is printed. What's going wrong? Call if you need a hint. 
Refer to Bug #525. 
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□ FAX #1082 □ 


A good example of window code that needs 
NMJRASEBKGND because it does not control the painting of 
its entire client area is the old style (non-3D) dialogs. The 
entire client area of a vanilla dialog is background, since 
the dialog does not paint anything upon receipt of 
NMJAINT (each child dialog control paints itself). So a dialog 
window will handle the NMJRASEBKGND message but has 
nothing to do on a NMJAINT. Contrast this with, say, a child 
window whose display is completely filled with a bitmap. 
It may as well ignore the NMJRASEBKGND message, since it 
must repaint its entire window with the bitmap image 
when it receives NMJAINT. 

It almost sounds like NMJAINT and NMJRASEBKGND are in¬ 
terchangeable, but watch out! It is 
possible to receive a NMJAINT mes¬ 
sage without first receiving 
NMJRASEBKGND. The Windows API func¬ 
tion InvalidateRectO (used to inform 
USER that a rectangular region on 
the given window needs repainting) 
accepts a parameter, fErase, that 
specifies if a NMJRASEBKGND message 
should be sent prior to the NMJAINT. 
Therefore, if your code calls Invali¬ 
dateRectO with fErase set to FALSE, 
you won’t receive a NMJRASEBKGND be¬ 
fore the NMJAINT. 

Now consider the case of the dia¬ 
log window for a moment. Unless 
you explicitly specify otherwise, the 
child controls on a dialog are created 
with the NSJHILD style and the dialog 
is created without the NSJLIPCHILDREN 
style. What this means is that the 
parent window (the dialog) of the 
child controls has free rein to draw 
on top of the controls. So a dialog, 
upon receipt of a NMJRASEBKGND mes¬ 
sage, will erase the entire client area, 
including the rectangles where the 
child control windows are. If you 
specify the NSJLIPCHILDREN style, then 
the child windows are clipped out of 
the update region. It is an interesting 
experiment to specify NSJLIPCHILDREN 
style for a dialog. You can do this on 
the DIALOG line in the resource script 
(.rc) file. The dialog will paint much 
more slowly than without the style, 
and the interior of the group boxes 
will not be erased. This means that 
group box controls do not handle 
NMJRASEBKGND, they rely on their par¬ 
ent to erase the background! 

Group boxes are supposed to be 
transparent. If they did erase their 
backgrounds upon receipt of the 
WM_ERASEBKGND message, then 
any controls underneath them would 
be erased. You cannot presume the 
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Figure 1 Using timeSetEventQ for periodic interrupts 


void init_timer(void) // start timer 
{ 

// address of callback func; 

LPTIMECALLBACK lpFunction - TimerFunc; 

UINT wResolution = 0; // max res 

UINT wPeriod = 2; // 2 ms == 500 Hz 

DWORD dwUser = 0; // not used 

timeBeginPeriodfwPeriod); // establish timer resolution 

// start the timer 

timerjd = timeSetEventtwPeriod, wResolution, 
lpFunction, dwUser. TIME.PERIODIC); 


// this is the interrupt routine in the DLL 
void CALLBACK ^export TimerFunctUINT wTimerlD, 
UINT wMsg, DWORD dwUser, DWORD dwl. DWORD dw2) 

{ 

// do something 

} 

// End of File 


Figure 2 Desired structure for nested interrupt 
handling 


II this is the interrupt routine in DLL 
void CALLBACK _export TimerFunctUINT wTimerlD, 

UINT wMsg, DWORD dwUser, DWORD dwl, DWORD dw2) 

{ 

semaphore^; // global variable 

//!! How to do this in Windows????? 
al low_new_timer_interrupt(); 

// if semaphore was 1, execute timer routine else 
// skip the main timer routine if this is a nested 
// int 

if (semaphore == 1) 

( 

// if semaphore > 0, nested interrupt 
while (semaphore) 

{ 

do_something(); 

semaphore--; // decrement semaphore 

} 

} 

// return from interrupt 

} 

// End of File 


order in which USER will send h/M_ERASEBKGND/MM_PAINT pairs 
to controls in a dialog, so this transparency of group 
boxes makes sense. 

Whether or not the control is part of a dialog is imma¬ 
terial. If you create a child control, it will behave exactly 


the same with respect to the parent window you specified 
when you created it, whether it is a dialog or not. The 
parent window is free to scribble over the control (unless 
the parent was created with the US_CLIPCHILDREN style). The 


Make a lasting first impression with EDI Install Pro 


EDI Install Pro is a powerful, full featured 
installation toolkit designed to make your 
work as effortless as possible. 

Standard, professional interface. 

Your customers will feel right at home with 
EDI Install Pro's 
standard, profes¬ 
sional interface. We 
don't clutter our 
windows with use¬ 
less gadgets or 
hokey graphics. In 
our opinion, a clean, standard interface, 
makes for a better product and leaves a last¬ 
ing impression. 

No script language to learn. 

Don't waste your time learning yet another 
script language, our simple information file 
makes creating powerful installations a 
breeze. In fact, using the INF Maker utility 
you can complete even complex installa¬ 
tions in less than an hour! 

Includes a complete uninstaller. 

Included with EDI Install Pro is an incred¬ 
ible utility that allows your users to remove 
your applications from their system in one 
easy step! Our uninstaller removes or 
changes .INI files; deletes application files, 


Program Manager groups and optionally 
user data files. 

No hidden costs! 

Unlike some of our 
competitors, we don't 
charge royalties, and we don't require that 
you purchase a license for each product 
you distribute. Ask our competitors about 
their licenses - you'll be surprised. 

You'll he in good company. 

What do AT&T, Banyan Systems, Bell Can¬ 
ada, BP Oil, Cirrus Logic, Fannie Mae, East¬ 
man Kodak, NCR Canada, Pacific Bell, Po¬ 
laroid Corp., SunSelect, TRW, Xerox, Ziff- 
Davis Publishing, and the US Army Corps 
of Engineers have in common? They all 
bought EDI Install Pro. Shouldn't you? 

Some EDI Install Pro Features: 

Standard, professional interface; 3D op¬ 
tional ♦ Dithered, tiled or bitmap back¬ 
ground ♦ Bulletin bitmaps (billboards) • 
Progress dialog 
keeps users in¬ 
formed ♦ Select¬ 
able components for custom installs ♦ No 
programming required ♦ DLL expandable « 
File compression & splitting ♦ Version re¬ 
source checking ♦ Disk branding with user 


name ♦ Auto font install ♦ Create & mod¬ 
ify .INI files ♦ Cre¬ 
ates Program Man¬ 
ager groups & icons 
♦ Built-in readme 
viewer ♦ Small size (~80Kb) ♦ Support for 
floppy, hard disk, CD-ROM, Network, and 
e-mail distribution ♦ Ask about our new 
OEM package! 

All this plus much, much more! 

Order Now For Only $179.95! 

See our evaluation version on the BBS, or on 
CompuServe's "WINSDK" forum, file "ll\ISPRO.EXE". 


^Spj©(p)Oi)(g(nt QlfiXgo 

24-2979 Panorama Drive Telephone/Fax: (604) 945-3198 
Coquitlam, BC V3E 2W8 Eschalon BBS: (604) 945-7602 

Canada CompuServe: 76625,1320 

VISA cards, US/Canadian checks and bank drafts accepted (order forms must accompany all 
draft orders). Sorry, no POs accepted. Canadian residents add 7% GST. BC residents add 7% 
PST. Add 510 Shipping & handling (515 overseas), 520 for federal Express (545 overseas). 

All Prices are in US currency. 

For European and multilingual orders, please contact: Windowshare SARL (France), 
voice at (+33) 87-30-85-57, fax at (+33) 87-32-37-75, or CompuServe at 100031,3257. 






EDI Install Pro, EDI Uninstall, and the Eschalon Development Inc. logo are trademarks of Eschalon Development Inc. Other names are (registered) trademarks of their respective companies. All prices and specifications sobject to change without notice. 


October 1994 


Windows/DOS Developer's Journal — Page 31 





























Listing 1 timer.c — Revised version of timer 
callback 



/* timer.c */ 
/* -- Revised version of Rolf Nilsson’s timer */ 
/* callback. */ 


♦include <windows.h> 

♦include <mmsystem.h> 

♦define dmscPeriod 2 // Timer period 

void CALLBACK .export TimerFuncdJINT wTimerlD, 
UINT wMsg, DWORD dwUser, DWORD dwl, DWORD dw2) 

{ 

DWORD mscNew, dmsc, msc = timeGetTimeO; 
do 

{ 

do.somethlngO; 
mscNew = timeGetTimeO; 
dmsc = mscNew - msc; 
msc = mscNew; 

} 

while (dmsc > dmscPeriod); 

} 

/* End of File */ 


control may or may not handle the UM_ERASEBKGND mes¬ 
sage, so your parent window should. 

The last piece of the puzzle is the UM_CTLC0L0R message. 
The built-in Windows dialog controls ('button', 'com- 
bobox', 'edit', 'listbox', 'scrollbar', and 'static") send this 
message to their parent after receiving either WM_PAINT or 
UM_ERASEBKGND, but before any drawing is actually per¬ 
formed. The wParam contains the device context the control 


will use for output to the screen. The message gives the 
parent a chance to make adjustments to the device con¬ 
text, such as the foreground and background colors and 
the selected pen and brush. See the 'Drawing-Attribute 
Functions' topic in the SDK online help for a complete list. 

I do not believe Microsoft intented the parent to per¬ 
form output to the control's client area using the device 
context in the UM_CTLC0L0R message. It doesn't make a lot 
of sense to do so, since when the parent window returns 
from the message, the control will just go ahead and per¬ 
form whatever output it was going to in the first place. 

Q l enjoyed the tear-off menus articles in W/DDJ. I 
have successfully used your DLL with MFC, and I 
thought other readers might be interested. I made all the 
changes to the CMainFrame class which AppWizard gener¬ 
ates. First tearoff.h needs to be included: 

extern "C" { 
f/include "tearoff.h" 

} 

In the header file, declare a function to override UindowProc. 
virtual LRESULT WindowProcCUINT msg, WPARAM wP, LPARAM IP); 
The implementation is: 
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LRESULT CMainFrame::WindowProc(UINT msg, WPARAM wP. LPARAM IP) 

{ 

FilterTearOff(this->m_hWnd, msg, wP, IP); 
return CFrameWnd::WindowProc(msg, wP, IP); 


I use the following code to update the status (in this case 
checking or unchecking) menu items: 

void CMainFrame::0nTestl() 

{ 

CMenu* pMenu = this->GetMenu(); 

if ((pMenu->GetMenuState(IDM_TEST_1. MF_BYCOMMAND)) 

& MF_CHECKED) 

pMenu->CheckMenuItem(IDM_TEST_1, 

MF_BYCOMMAND I MFJJNCHECKED); 

else 

pMenu->CheckMenuItem(IDM_TEST_l, 

MF_BYCOMMAND | MF.CHECKED); 

HMENU hMenu = (pMenu->GetSubMenu(3))->mJiMenu; 

UpdateTearOffs(this->m_hWnd, hMenu); 


I don't particularly like having to hard-code the ordinal 
'3' into the GetSubMenuO call, but it seems to work fine. 
Also, I don't see any way to support the UI_COMMAND stuff 
that MFC uses since it works exactly the way you say not 
to work (i.e., it does not set the menu state until it is 
popped up). I hope that you or another reader may have 


devised a solution to this latter problem, but in the mean¬ 
time, the old-fashioned way (as shown above) works fine. 

Randall M. Smith 
rsmithl@cerf.net 

A Thanks for sharing the MFC glue you used to get the 
code working. You are forced to use ordinal numbers 
for submenus since Windows does not provide any other 
abstraction for referring to a popup menu. Rearranging 
the popup menu order in the resource file means chang¬ 
ing the ordinals in your code, a real pain. Too bad the 
Windows team has not yet added an identifier tag that 
can be placed on the 'POPUP' line in the resource file, just 
like it is for "MENUITEM' lines. If they then extended the 
popup menu API functions to accept a menu identifier, as 
the menu item API functions do when the MF_BYCOMMAND 
flag is used, you wouldn't have code dependencies on the 
menu layout in the resource file. As for UI_COMMAND, good 
question. If any readers have any thoughts on this, please 
let me know. □ 

Correction to September's Q&A 

In my discussion of Ton Plooy's letter concerning INT 
21 h trapping in the September Q&A column, I noted that 
what he had written had implications for my VxD article 
in the June 1994 issue. In fact, the article in question, enti¬ 
tled 'A VxD to Monitor DOS Output,' appeared in the May 
1994 issue. My apologies to all for whom this created 
confusion and thanks to Joe Masters for pointing it out. 
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Fixing the FIXED Memory 
Problem 

Troy Acott and Gus Spooner 


=E2= 

Borland C++ V4.0 

Symantec C++ v6.1 


Visual C++ vl .5 


After loading our Windows application (which consists of several .exes and 
.dlls), we were unable to launch other applications. Windows reported that 
there was insufficient memory to load another application. Our system had 
plenty of free extended memory, so the problem seemed to be a shortage of 
some other system resource. This article describes how we figured out and 
fixed the problem and how you can avoid it in your own application. Before 
implementing this fix, we could rarely run more than one DOS box after load¬ 
ing our application: now we can run many DOS boxes or other Windows appli¬ 
cations. 

Background 

Although Windows has access to all the extended memory on your system, 
it is still basically just a DOS extender, and it needs to use conventional mem¬ 
ory (memory below 1Mb) to communicate with DOS (to pass data to INT 21h, 
for example). When Windows loads an application, it has to allocate a block of 


Troy Acott is a consultant with Harmonic Software, Beaverton, OR. He holds a BS de¬ 
gree in psychology, math, and computer sciences, and specializes in writing video con¬ 
ferencing software. 

Gus Spooner is a consultant with Step Technologies, Portland, OR. He received a BS 
degree in math, computer science, and digital electronics from the University of Wis¬ 
consin - Stevens Point He is currently occupied with writing VxDS and protocol drivers 
for network stacks. You may reach Gus via CompuServe at 70062,3260. 
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at least 512 bytes of conventional memory for the appli¬ 
cation's Program Segment Prefix (PSP). DOS uses the PSP, 
so it has to reside in conventional memory where DOS 
can access it. If Windows cannot allocate this memory, it 
will report 'Insufficient memory to run app.' Since conven¬ 
tional memory is much more limited than extended mem¬ 
ory, it would make sense for Windows to use it sparingly. 
Unfortunately, that is not always the case, due to the strat¬ 
egy used by the Windows memory manager. 

The Windows memory manager tries to keep fixed or 
page-locked memory blocks low in memory, while putting 
discardable blocks high in extended memory. The motiva¬ 
tion behind this algorithm is to reduce memory fragmen¬ 
tation. However, 'low in memory' means that Windows 
will use conventional memory first if it is available, using 
up a scarce resource (see Matt Pietrek's Windows Internals 
[Addison-Wesley, 1993] for an in-depth look at the algo¬ 
rithms that Windows uses for memory management). 

There are a couple of conditions under which your ap¬ 
plication might need fixed or page-locked memory and in¬ 
advertently use up conventional memory. First, if some 
part of your code (typically DLL code) is accessed at inter¬ 
rupt time, you must mark that code segment FIXED. When 
Windows loads a DLL, it tries to move any FIXED segments 
low in memory, and will place them in conventional mem¬ 
ory if they fit (Windows ignores the FIXED directive for 
.exes, so this is only a problem with DLLs). 

Second, if your application calls Global PageLockO, Win¬ 
dows tries to move the block low in memory (wasting 
conventional memory if it fits there) before page-locking it. 
One possible reason for calling GlobalPageLockO is to dy¬ 
namically allocate memory that will be accessed at inter¬ 
rupt time. 

DLLs are probably the biggest cause of wasted FIXED 
memory, however. The Microsoft Developer Network CD- 
ROM contains a technical note (Knowledge Base article 
Q66360) that claims that if your DLL contains a WEP 
(Windows Exit Procedure), the code segment containing 
your UEPO must reside in a fixed segment. Most DLLs 
have a UEPO, so if they follow Microsoft's guidelines, they 
will be using up conventional memory. This problem is 
particularly ironic, since more than one Microsoft support 
team member has stated that the UEPO need not be FIXED 
in Windows 3.1. Unfortunately, Microsoft continues to ship 


documentation (the Visual C++ vl .5 documentation is the 
most recent example) that encourages programmers to 
make the UEPO FIXED 

History 

Our first workaround was to start several DOS boxes 
before running our application, then close them after our 
application started (leaving at least some conventional 
memory available for PSPs). This worked and also helped 
confirm the problem, but was obviously not a long-term 
solution. 

Next, we wrote a DLL called stmem. stmem.dll was a 
memory manager designed to be used in place of Glo¬ 
bal All oc() and friends. At startup, stmem.dll allocated and 
page-locked a very large pool of memory. Since this pool 
was too large to fit in conventional memory, it was a 
guaranteed source of fixed memory that lay outside con¬ 
ventional memory. However, we didn't realize at the time 
that FIXED DLL code and data segments were also a prob¬ 
lem, and so stmem.dll did not address them. 

Our second workaround, grabmem.exe, allocated a chunk 
of conventional memory at startup and freed it at termi¬ 
nation. So if we ran grabmem.exe, then ran our own applica¬ 
tion, then terminated grabmem.exe, the chunk of conven¬ 
tional memory that grabmem.exe had grabbed was not ab¬ 
sorbed by our application. This worked, but we considered 
it a last-resort solution. 

Our third attempt was a different version of grabmem.exe. 
At this point, we knew that applications were failing be¬ 
cause they could not allocate a 512-byte PSP from con¬ 
ventional memory. We changed the code to allocate as 
many 512- byte blocks as possible and then free up every 
other one. This approach guaranteed that we could run at 
least n/2 applications (where n was the total number of 
512-byte blocks that could be allocated), but wasted mem¬ 
ory. Still, it could be a useful solution if you have to load 
someone else's .exe or .dll that unintentionally wastes 
conventional memory. 

Our final solution directly addressed the problems for 
our application. It makes sure that neither memory seg¬ 
ments marked FIXED in the DLL nor memory segments 
made FIXED by calling Global PageLockO can waste any con¬ 
ventional memory. 
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Listing 1 

functions 


pglock.h — Definitions for page-locking 


^include <windows.h> 

LPVOID Hack_DosFragment (DWORD dwSize); 

void Hack_DosUnfragment (LPVOID pList); 

UINT Hack_GlobalPageLock (HGLOBAL SelMem); 
/* End of File */ 
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Our final solution directly addressed the problems for 
our application. It makes sure that neither memory seg¬ 
ments marked FIXED in the DLL nor memory segments 
made FIXED by calling GlobalPageLockO can waste any 
conventional memory. 

Keeping FIXED Memory above 1 Mb 

We wanted to keep both DLL memory marked FIXED 
and memory locked by GlobalPageLockO from being put in 
conventional memory. Our solution is in pglock.h (Listing 
1) and pglock.c (Listing 2). The simplest case is if you need 
to lock some memory dynamically at runtime; just call 
Hack_GlobalPageLock() instead of GlobalPageLockO. When 
locking a page, Windows normally 
would try to move it as low in 
memory as possible. To prevent 
Windows from relocating the page 
into precious DOS memory, 
Hack_GlobalPageLock() calls Global- 
DosAllocO repeatedly to use up all 
DOS memory blocks that are big 
enough to contain the page about to 
be locked. At that point, Hack_Global- 
PageLockO can then safely call Global¬ 
PageLockO to lock the page and then 
free up the DOS memory that it allo¬ 
cated. 

But what if you want certain code 
segments in your DLL to be FIXED? 
For example, if you have interrupt¬ 
handling code in your DLL, you 
would typically mark it FIXED in your 
.def file because you have to guaran¬ 
tee that the code will not be 
swapped out when an interrupt oc¬ 
curs. The problem is that when Win¬ 
dows loads your DLL, it will try to put 
that FIXED code segment in low mem¬ 
ory, using up DOS memory again if it 
is available. 

Our solution is to avoid marking 
DLL segments FIXED and to page-lock 
them explicitly ourselves at runtime. 
To do that, just pass the selector of 
the page to be locked to Hack_Global- 
PageLockO. An easy way to obtain the 
selector of a code page that contains 
a specific far function is to pass the 
address of the far function to the 
SELECTOROFO macro defined in win¬ 
dows. h, like this: 


++ 

Users journal 



++ 

Users lournal 


CALL: 913-841-1631 
FAX: 913-841-2624 


Non U.S. orders must prepay ($46 Canada/Mexico, $65 outside North America) in U.S. funds. 


extern int WINAPI FarFuncO; 

Hack_GlobalPageLock((HGLOBAL) 
SELECTOROF(FarFunc)); 

You could also use the address of a 
variable if you want to lock the de¬ 
fault data segment: 
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int Dummy; Finally, you may sometimes have to load someone 

Hack_Gl obal PageLock( (HGLOBAL) else's DLL or application that inadvertently uses up DOS 

SELECTOROF(Dummy)); memory. If you know that is the case, you can call 

Hack_DosFragment(), load the target module, and then call 


Listing 2 pgtock.c — Code to solve FIXED memory problem 

finclude "pglock.h" 

// Hake sure that a least one PSP is available. 

// That way if a LoadLIbrary is trying to load a DLL that 

#define kPspSize 512 

// has fixed segments declared in the def file, they will 
// get loaded high. 

//. 

// Also if we do this then the min memory size should be at 

// Hack DosFragment 0 

// least this big. 

// 

II 

// Fragment up the Dos memory into the sizes specified so 

II Do not try to worry about small amounts of memory. 

// any GlobalPageLockC) will not be able to move the memory 

// Host code will not be affected by small blocks. 

// into the Dos area. 

// Hust never go below 4 because pointers are stored in 

// 

// memory allocated for the purpose of freeing the blocks 

// All of the pointers will be saved along the way so this 
// operation can be undone. A pointer to this memory list 

// later. 

// will be returned and should be passed to 

if (kPspSize > dwSize) 

// Hack_DosUnfragment(). The dwSize passed in should be 
// GetSelectorLimitO for best results or if not available 

return(pList); 

// a number like IK should do fine. 

//. 

dwPspDosAlloc ■ GlobalDosAl1oc(kPspSize); 

while ( (dwDosAlloc=GlobalDosAlloc(dwSize )) != 0 ) 

LPVOID Hack DosFragment (DWORD dwSize) 

{ 

{ 

pNext = (LPDWORD)(dwDosAlloc « 16); 

LPDWORD pList = NULL; 

*pNext = (DWORD)pList; 

LPDWORD pNext; 

pList = pNext; 

DWORD dwDosAUoc; 

DWORD dwPspDosAlloc; 

) 

if (dwPspDosAlloc) 

GlobalDosFree( LOWORD(dwPspDosAUoc) ); 
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Hack_DosUnfragment(). That will keep the other module from 
using up large chunks of DOS memory. 
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Summary 

Until Windows becomes a true 32-bit operating system, 
the FIXED memory problem is likely to persist. There's 
nothing more irritating than investing in many megabytes 
of physical memory and then seeing Windows choke due 
to internal limitations. By being careful about how you al¬ 
locate FIXED memory, you can avoid contributing to the 
problem. □ 


Listing 2 continued 


return(pList); 

} 


//. 

// Hack_Dosllnfragment 0 

// Do the inverse of Hack_DosFragment(). 

//. 

void HackJosUnfragment (LPVOID pList) 

{ 

LPDWORD pNext; 

while (pList) 

{ 

pNext = pList; 

pList = (LPDWORD)*((LPDWORD)pLi st); 
GlobalDosFreel SELECTOROF(pNext) ); 

) 

} 


//. 

// Hack_GlobalPageLock 0 

// Call this in place of GlobalPageLockO. 

II 

// Warning: If GlobalPageLockO is used on previousely 
// GlobalPageLock’d memory, you will still fail because 
// Windows will still move the locked memory. Also if a 
// linear address is cached it may now be invalid. 

//. 

UINT Hack_GlobalPageLock (HGLOBAL SelMem) 

{ 

UINT Return; 

LPDWORD pList = NULL; 

DWORD dwSize; 


dwSize = GetSelectorLimitt(UINT)SelMem); 

// Fragment up the DOS memory. 
pList = Hack_DosFragment(dw$ize); 

II PageLock our mem which should stay above the IMeg line 
// because of all the fragments. 

Return = G1obalPageLockISelMem); 

// Free our Dos fragments. 

Hack_DosUnfragmenttpList); 

return(Return); 

} 

/* End of File */ 
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Books in Brief 

First Impressions of Recent Titles 


Ron Burk 


Software has undergone some changes in the last dec¬ 
ade that publishers have not quite caught up with. First, 
software is nowadays a common subject of litigation. Peo¬ 
ple get sued for using algorithms someone else has pat¬ 
ented, for using code without obtaining the correct rights 
or permissions, and even for plagiarizing code that they 
themselves wrote for someone else. Second, publishers 
are now cranking PC programming books out at an 
astonishing rate, and many of these books consist mainly 
of source code. In such cases, the source code in the book 
may be the one and only reason that programmers buy it. 

Despite these trends, most publishers still ignore the 
source code in programming books. More precisely, they 
don't treat it legally any differently than the text in the 
book. Although the publisher may not have the slightest 
interest in being in the software business, the fact that the 
front of the book contains a copyright notice means that 
the publisher owns the software, and you do not have 
any permission to make use of it after you purchase the 
book, or even to create your own software that looks too 
similar to the code you looked at in the book. 

The problem is not that publishers are going to start 
suing programmers who make use of code printed in pro¬ 
gramming books, although that is not unimaginable. The 
problem is that we have entered an age where relying on 
such an informal understanding (that it's OK to use code 
from a programming book, even though the book is copy¬ 
righted) is no longer a legally prudent practice for you or 
your company. It would be better for all concerned if pub¬ 
lishers would clearly state what rights are being granted to 
the source code that they publish. Some publishers al¬ 
ready do this for some books, but they are in the minor¬ 
ity. It is ironic that books whose covers tout the fact that 
they contain valuable source code often give you no right 
to use that source code after you buy the book. 

W/DDJ can do a couple of things in response to this 
situation. First, if you look on our table of contents page, 


you will see that we have added a line to our 'Online 
Source Code' box that explicitly permits you to make use 
of the code we publish in the magazine. Second, starting 
with this column, I will point out whether books that con¬ 
tain significant source code grant you the right to use that 
source code. If you read on, you will see that it is not 
always easy to determine what rights the author or pub¬ 
lisher intended you to have. Nevertheless, if you are buy¬ 
ing a book whose value resides in the source code it con¬ 
tains, you have a right to know whether you are merely 
buying permission to study the code or permission to ac¬ 
tually make use of the code in your own applications. 


* WILEY -Wir nottniOKnt (WW.TW 
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Object-Oriented Ray Tracing 
in C++ 
Nicholas Wilt 
$69.95, with disk 
461 pages 
Wiley, 1994 
ISBN 0-471-30415-8 


Ray-tracing refers to a class of algorithms for drawing 
realistic, 3-D computer images. The basic idea is to take 
mathematical descriptions of object shapes/surfaces and 
light sources, and mathematically calculate a ray from the 
viewer's 'eye' to each visible point in the scene. By also 
calculating the effect of the surface of each visible point 
given the light sources, you can calculate the color that 
each point (pixel in the resulting image) should be. 

Nicholas Wilt is the author of OORT, a publicly avail¬ 
able ray tracer written in C++. OORT does not use a ray 


You can order any of the books that appear in Books in Brief from R8D Publications by calling (913) 841-1631, faxing 
(913) 841-2624, or sending email to rdorders@rdpub.com. If using fax or email, send the book title, author, and publisher 
along with your MasterCard or Visa number, expiration date, and phone number. 
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tracing language to describe images (objects, light sources, 
etc.); instead, you use C++ statements to accomplish the 
same thing. This book contains the source to OORT along 
with a moderate amount of text describing elementary 
graphics concepts, the design of OORT, and (just as inter¬ 
esting) design paths not taken. The text is good about cit¬ 
ing the works from which various algorithms are taken, 
giving you a chance to read the original description or 
pursue additional information. 

This is the book that really got me thinking about pro¬ 
gramming books and copyrights. Clearly, the core of this 
book is its software. In the introduction, the author en¬ 
courages you to use and even distribute this source code, 
saying in part, 'Feel free also to incorporate it into your 
own programs.' However, the actual source code contains 
copyright notices that say the code 'may not be included 
in whole or in part into any commercial package without 
the express written consent of the author.' To make 
things a little more ambiguous, the publisher inserted a 
card with the code disk claiming that the code 'is copy¬ 
righted, and all rights are reserved.' The publisher seemed 
a little unclear about the price for the book as well. The 
back cover says $69.95, but a flyer for the book claimed 
$49.95. The flyer says the book without the code disk 
costs $36.95, which might be the way to go since you can 
download OORT from CompuServe. 

I contacted the author (he includes his email address in 
the book) and my understanding is that he really only 


intends to prevent the obvious abuses of the source code, 
such as publishing it (e.g., in a book or magazine article) 
for profit. In other words, it really is OK to distribute the 
source code or use it in your own application, personal or 
commercial. But you will probably want to go to the 
trouble to get written permission if you actually use any of 
this code in a commercial application. 

If more academic texts on ray tracing are too mathe¬ 
matical and abstract for you, this book could be ideal - 
you get working source code to tinker with while you are 
reading less formal descriptions of various algorithms. You 
can even grab the code from some public source (the 
GRAPHDEV forum on CompuServe contains this and other 
ray tracing programs) and try it out before you risk buying 
the book. What could be better? 
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Programming in C++ 
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509 pages 
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Lightning-Fast Animation 
Graphics 
Len Dorfman 
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As with the previous book, ray tracing is at the heart of 
this one. After some introductory information on accessing 
the PC graphics hardware (like most high-end graphics, 
the code here is for DOS, not Windows), the book starts 
building toward a complete ray-tracing program. The 
chapter headings give a fair picture of the contents: 'Se¬ 
lecting Colors with an Octree'; 'Displaying TGA Files'; 'Dis¬ 
playing Four Pictures on a Single Screen'; 'Saving and Re¬ 
storing .PCX files'; 'The Vector Class'; 'Ray Tracing Lan¬ 
guage Description'; 'Processing Objects with Object-Ori¬ 
ented Programming"; "Ray Tracing"; 'Spheres'; 'Planes and 
Polygons'; 'Boxes'; 'Rings and Circles'; 'Quadric Shapes', 
'Cones', and 'Cylinders'; 'Constructive Solid Geometry"; 
'Textures and Surfaces'; 'The Ray Tracing Program'; "Ani¬ 
mation'; 'Using Pictures from Kodak CD-ROMs." 

I did not spot anything in the book granting you per¬ 
mission to make use of the code. The included disk con¬ 
tains a copyright notice reserving ail rights. 

Unlike Wilt's OORT, this ray tracing program includes a 
language; you can create script files that describe the 
scenes (objects, light sources, perspective, etc.) that the 
program is to render. C++ classes are used throughout 
most of the code. Sadly, this book contains no bibliog¬ 
raphy or reading list, and the text is not good about citing 
sources for algorithms (I'm not sure it cites any sources at 
all). The book is essentially a somewhat terse explanation 
of a reasonably simple ray tracing language and program. 
The Nicholas Wilt book seems superior to me. 


This book was difficult to examine because I was im¬ 
mediately hypnotized by the number of zeros on its 
pages. 1 know this sounds odd, but this book is crammed 
with zeros - it contains no less than 102 pages of zeros. 
When I say 'zeros,' I mean that each of these 102 pages 
contains nothing more than 53 lines that look exactly like 
this: 

0 , 0 , 0 , 0 , 0 , 0 , 0 , 

I am not making this up. I am not even counting the 
pages that are mostly zeros, only the ones that are abso¬ 
lutely, completely, totally, nothing but zeros. Why are 
these zeros here? They exist in C source code listings to 
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initialize static arrays of characters that represent sprites, 
ironically, although the arrays have some non-zero data 
towards the beginning, all the zeros are at the ends of 
these arrays. That's right, the 102 pages of zeros exist to 
explicitly initialize data that the language guarantees 
would be implicitly set to zero anyway! 

Try as I might, I couldn't get those zeros out of my 
mind. Did the editors (the book claims there were two) 
raise nary an eyebrow at the sight of a sea of zeros? Did 
they not consider including helpful notices like 'This page 
intentionally full of zeros'? Almost exactly one-fourth of 
the book is zeros, and I wondered if it would have cost 
only $26.21 instead of $34.95 if they had been omitted. 
This is no mere incompetence at work here - the only 
thing that separates this book from Christo-like artistic per¬ 
fection is that it is cluttered with less pristine pages that 
do not consist of zeros. How the trees in the forest must 
tremble when this author sets pen to paper! 

I suppose I should say something about the non-zero 
portions of the book. The book consists of C and assem¬ 
bly code for doing PacMan-style sprite animation for VGA 
adapters (DOS, not Windows). In an attempt to make the 
code look like book chapters, there are a few pages of 
text to briefly describe each big wad of source files. The 
source includes a sprite editor. The book comes with a 
disk that contains the approximately 350 pages of code 
that make up the book. Some chapters explicitly say you 
can make use of the source, some do not; the publisher 
takes a less liberal view with a blanket copyright for the 


code disk. The book cover claims that the material on the 
disk is worth over $200. Well, as anyone who buys PC 
programming books knows, the price of zeros just keeps 
going up. 



Programming for Graphics 
Files in C and C++ 
John Levine 
$49.95, with 3.5" disk 
506 pages 

John Wiley and Sons, Inc., 1994 
ISBN 0-471-59856-9 


There are lots of graphics file formats in the world, and 
lots of code of varying degrees of quality to read and 
write those formats. The author has gathered up a batch 
of public domain file format code, ported it to DOS, made 
a few improvements, and produced this book. File formats 
covered include a variety of simple bitmap layouts, MacPaint, 
PCX, IMG (GEM), IFF/ILBM, BMP, Targa, GIF, TIFF, JPEG, HPCL, 
Windows metafiles, HP PCL, PostScript. That's a lot of ground 
to cover and, as you might suspect, individual formats are 
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not covered in much depth. For example, the code for 
Windows BMP files ignores compressed BMP files as unim¬ 
portant. 

There are virtually no figures in the book, quite a 
waste when you consider that the book is about file for¬ 
mats. Instead, you will have to construct your own pic¬ 
tures of the file formats, by reverse-engineering them from 
C structure declarations and other code. In fact, the text 
does not really describe the file formats much, preferring 
instead to describe code that reads them. Since the text 
also does not give you any information on how to obtain 
the real specifications for the file formats, if you want to 
implement more than the subset of abilities provided in 
the code, you are out of luck. 

Most of the code in this book comes from public do¬ 
main libraries, and the book explicitly gives you the right 
to use and modify it (you have to preserve copyright no¬ 
tices). Unfortunately, the publisher (Wiley) tucked a notice 
in with the code disk that says you must agree that the 
contents are copyrighted and all rights are reserved. In 
this case, the publishing house clearly is claiming rights it 
does not have. The text does not add that much value to 
the code, and you could download a whole lot of public 
domain graphics code (or buy a CD-ROM full of it) for 
$49.95. 
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Virtual Reality Excursions 
With Programs in C 

Christopher Watkins and Stephen 
R. Marenka 

$49.95, with 3.5" disk 
527 pages 

AP Professional, an imprint of 
Academic Press, Inc., 1994 

ISBN 0-12-737865-0 


Virtual reality is now a bona fide media buzzword. My 
favorite sound bite came from a local TV news piece on 
the subject: 'Virtual reality is here now, and it has virtually 
hundreds of uses." All this hype virtually guarantees a 
flood of books designed to capitalize on it. This book 
seems like one of the more appropriate ones for program¬ 
mers. 

This book is really two separate books. The first half is 
an informal, wide-ranging discussion of the history and 
potential future of virtual reality. This makes for light, in¬ 
teresting reading, including lots of neat facts about the 
odd way our senses (sight, hearing, etc.) behave. The sec¬ 
ond half of the book is code and commentary about how 
the code works. Can you create photo-realistic virtual real¬ 
ity effects with this code? Certainly not - the PC just 
doesn't have the horsepower to do the kind of stuff you 
see in the movies, not in real time anyway. However, you 
can create little block-figure worlds (for DOS) where things 
move around and can be viewed from various perspec¬ 
tives. 

You are definitely not free to make use of the source 
code published here, as both the source code copyright 
and the programs (when you run them) make clear. If you 
want to use the source in some other program, the author 
of the code wants you to contact him for licensing ar¬ 
rangements. In fact, if you are writing similar types of 
code, you may want to avoid reading this book; offhand 
comments in the code gave me the feeling the author al¬ 
ready feels one or more people have ripped off his source 
code in the past - why leave yourself open to a charge of 
plagiarism? 

I guess I should be more excited about virtual reality, 
but unfortunately, I subscribed to Popular Science as a 
youngster, which leaves me irritated that I still do not 
have a personal jet pack for transportation, or a video 
phone (or even a two-way wrist radio) for communication. 
Not everything that can be, will be, at least not in a way 
relevant to everyday life. If you are less cynical and are 
interested in thinking and reading about the amazing pos¬ 
sibilities of virtual reality, and even playing with some 
code (without actually doing anything commercially vi¬ 
able), then this book is for you. The bottom line is, virtu¬ 
ally any book that comes with its own 3-D viewing 
glasses (they really work!) can't be all bad. 
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Graphics Gems IV 

Edited by Paul S. Heckbert 
$49.95, with 3.5" disk 
592 pages 

AP Professional, an imprint of 
Academic Press, Inc., 1994 

ISBN 0-12-336155-9 


As the title implies, this book is the fourth in a series. 
Each book is made up of articles submitted by members 
of the high-end graphics community, people at universities 
and companies like Xerox PARC, Autodesk, and Industrial 
Light and Magic. The articles range from simple and easy 
to understand ('XOR-Drawing with Guaranteed Contrast,' 
which discusses the best color for rubber-band lines) to 
the more esoteric ('Contrast Limited Adaptive Histogram 
Equalization,' an image processing technique useful for, 
say, making MRI scans more readable). 



The book is a grab bag of tips and techniques, most of 
which come with source code. The articles are not as for¬ 
mal as in strictly academic publications, but they do as¬ 
sume you have serious graphics experience (if you don't 
know what NURBs are, you won't get much out of 'Tessel¬ 
lation of NURB Surfaces'). The articles are grouped into 10 
chapters: "Polygons and Polyhedra', 'Geometry', 'Transfor¬ 
mations', "Curves and Surfaces', "Ray Tracing", "Shading", 
'Frame Buffer Techniques', 'Image Processing', 'Graphic 
Design', and 'Utilities.' 

The book explicitly grants you permission to make 
most any use of the source code. In fact, the source is 
widely available (e.g., gemsiv.zip in forum GRAPHDEV on 
CompuServe). Sometimes the code is far from trivial, in¬ 
cluding complete C++ vector libraries, and reusable code 
to polygonize parametric and implicit surfaces. The code is 
mostly intended to be portable. 

I like this book and I like the series - I wish I had them 
all in my library. If you write high-end graphics code for a 
living, well then you probably already have this book, so 
there's no point in my recommending it to you. I wish 
there were more book series like this, bridging the gap 
between academia and industry, cross-pollinating the best 
concrete programming information among programmers 
within a given specialty. 


2 . 

Graphical Instrument Library 

The universal library for building 
fast graphical displays for data 
acquisition and control. 



r> 

v&s 


Rich set of instruments includes: 

Dial gauges, bar gauges, thermometers, seven-segment 
displays, strip-charts, annunciators, alarms, signal 
conditioning, 100 timers, PID control and more! 

All instruments are fully scalable, 90 degree rotatable, 
and optimized for maximum thruput, with minimum code size 

One version supports Turbo C, Microsoft C, QuickC, 
QuickBASIC, PDS7.1, & Visual Basic for DOS! 

For a free demo, call ^[Advanced 

( 404 ) 352-4788 B^MSolutiom I 

1920 Moores Mill Rd., Atlanta, GA 30318 


□ Request 165 on Reader Service Card □ 

October 1994 




Making C++ more 

COMFORTABLE FOR 

Program mers 




SOURCERER makes pro¬ 
gramming with Visual C/C++ easier aiul 
more comfortable than ever before. 

The program offers: 

♦ Immediate access to all functions, classes, structures, and 
macros without prior compiling or saving. 

♦ High speed parsing for C, C++, and assembler code 

♦ multiple copy I past buffers 

♦ Bookmarks that work the way you expect them to 

♦ Language sensitive commenting and uncommenting 

SOURCERER functions are easily accessed using the Visual 
C++ menu by just clicking the mouse. 

Convince yourself. Order today. 



Cl3 software GmbH • Ricsstrajle 17 • X0992 Miinelien / Germany 
Tel.: +491X91143 60 0 ♦ Fax: +491X91143 60 100 • or CIBCompiiServ 100065. 165 

Important: Please enclose chct/ue or money order. For fax orders, or ordering via 
CompuServe, please send payment by mail. 


□ Request 122 on Reader Service Card □ 

Windows/DOS Developer’s Journal — Page 45 











































Windows Animation 
Programming with C++ 

Michael J. Young 
$39.95, with 3.5" disk 
312 pages 

AP Professional, an imprint of 
Academic Press, Inc., 1994 

ISBN 0-12-773750-2 

The word 'animation' 
conjures up images of car¬ 
toons and games. However, 

Windows programmers run 
into animation under more mundane circumstances. For 
example, if your application lets the user 'grab' something 
with the mouse (e.g., a box in a flow-charting program) 
and move it to a new location, that is animation, too. And 
what Windows programmer, burnt out as the product 
nears its ship date, has not contemplated taking off a few 
hours to make the icon in the About box do a little 
dance? This book provides explanations and C++ code to 
implement sprite animation (little bitmaps that move 
around) and frame animation (changing a block of graph¬ 
ics periodically so that the contents appear to move). 

The writing is clear and makes good use of figures to 
explain what is, after all, a visual task. Little knowledge is 
assumed, and the book's introductory chapters even try to 
introduce you to basic Windows programming. This book is 


a gentle introduction to simple animation, and it sidesteps 
problems that more intensive Windows animation raises. 
In particular - and most damagngly - the book avoids 
altogether the issue of device dependence. Rather than 
explaining device-independent bitmaps (DIBs) and how to 
use them, the book recommends you stick to bitmaps that 
only use the 16 standard colors. Palette animation is not 
covered. The DIB driver is not covered. I wish the author 
had not tried to teach Windows and C++, and used that 
space instead to go into more depth on the real topic, 
Windows animation. If you really don't know Windows, 
skip this book and buy Petzold; you'll get a whole lot 
more about Windows programming, and still leam how to 
do simple animation. 

As best I could tell, the book vaguely implies you can make 
use of the code, but the publisher put a copyright notice both 
on the diskette label and in a file on the diskette. This code ain't 
rocket science, and for $39.95 you ought to at least get the 
right to cut-and-paste a few useful lines here and there. 

If you want to get information on fast, device-inde¬ 
pendent animation (including source code examples), get 
the MSDN CD-ROM, which contains articles like 'Anima¬ 
tion in Windows,' 'SSPAL: Self-Study Module on Palette 
Animation,' and so on. You may also want to obtain 
WinG (from the WINMM forum on CompuServe), and the 
'Writing HOT Games for Microsoft Windows' document 
that goes with it. If you read the Microsoft animation arti¬ 
cles and find them just too difficult to comprehend, then 
consider plopping down your hard-earned $39.95 for the 
more elementary information in this book. □ 
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Driver Bug of the Month 


Paul Bonneau 



Visual C++ vl .5 
Borland C++ v4.0 
Symantec C++ v6.1 


This month, I focus once again on a bug in an HP Win¬ 
dows device driver - the DeskJet 550C. The bug exists in 
both version 3.0 and the more recent version 4.0 of the 
printer driver. The problem occurs when an application at¬ 
tempts to override a paper size using the ResetDCO Win¬ 
dows API function. 

This is not all that uncommon a situation. For example, 
a simple application might print ail output as a single size 
bitmap. If the user has set the paper size to something too 
small, such as envelope, the program could reasonably 
temporarily override the settings with ResetDCO, inform the 
user that it will use larger paper, and perform the output. 
One way to do this would be to call the printer driver's 
DeviceCapabilitiesO function if it has one (the DeskJet 
550C does), and query the available paper sizes. Then the 
smallest such paper greater than the required output size 
could be chosen, and the width and height values used to 
choose that paper via ResetDCO. 

ResetDCO is an extremely handy API to use when print¬ 
ing. It allows the application to exert a lot of control over 
the print job, but without permanently altering the default 
settings as specified in the control panel. ResetDCO accepts 
a handle to a printer device context (DC) and a pointer to 
a filled-in DEVMODE structure. The application can set various 
fields in the DEVMODE structure to control the print job. The 
DEVMODE structure definition, as well as various constants, 
can be found in the header file print, h, in the same direc¬ 
tory as your windows.h file. 


Paper sizes can be specified in one of two ways. The 
first is by setting one of the predefined paper sizes speci¬ 
fied by the constants in the range DMPAPER_FIRST to DMPA- 
PER_LAST into the DEVMODE s dmPaperSize member. The other 
method is to set the DMPAPER_USER constant into dmPaperSize 
and to set values for the desired width and height (in units 
of tenths of a millimeter) into the dmPaperWidth and dmPa- 
perLength members. The latter method has problems on 
the 550C. 

hp550c.c (Listing 1) is a small program that demon¬ 
strates the bug. To see the bug you must have the HP 
DeskJet 550C driver installed and set as the default printer 
in the control panel. The program uses the common dia¬ 
log PrintDlgO function to obtain a device context and a 
DEVMODE for the printer, then calls the helper function Show- 
MetricsO, which invokes a message box to display the 
printing offset and horizontal and vertical resolutions for 
the current state of the device context. On most non-dot- 
matrix printers, an unprintable region frames the inner 
rectangle on the paper that can actually be printed to: the 
printing offset is the location of the upper left-hand comer 
of the printable rectangle from the upper left-hand comer 
of the physical page. The horizontal and vertical resolu¬ 
tions give the number of pixels that can be printed within 
the printable rectangle. 
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Listing 1 hpssoc.c 


/*****************************************************/ 
/* hp550c.c */ 

/* -- Program repros the paper select escape bug */ 
/* with the HP 550C printer driver. */ 

/a****************************************************/ 


#include <windows.h> 
#include <commdlg.h> 
#include <print.h> 


void ShowMetricsCHDC hdc); 


#ifdef _B0RLANDC__ 

#pragma argsused 
#endif 

int PASCAL WinMainCHINSTANCE hins, HINSTANCE hinsPrev. 
LPSTR lpsz, int wShow) 

/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★Hr**************/ 

/* -- Entry point. */ 

/**★**★★★*★★★*★*★★*★★**★★**★*★***★******★*******★*****/ 
{ 

LPDEVMODE lpdvm: 

PR1NTDLG pdg; 

pdg.lStructSize = sizeof pdg; 
pdg.hwndOwner = NULL; 
pdg.hOevHode = NULL; 
pdg.hOevNames = NULL; 
pdg.hOC = NULL; 

pdg.Flags = PD_RETURNDC I PD_RETURNOEFAULT; 
pdg.nFromPage = 0; 
pdg.nToPage = 0; 
pdg.nMinPage = 0; 
pdg.nMaxPage = 0; 
pdg.nCopies = 0; 
pdg.hlnstance = NULL; 
pdg.lCustData = NULL; 
pdg.1pfnPrintHook = NULL; 
pdg.lpfnSetupHook = NULL; 
pdg.lpPrintTemplateName = NULL; 
pdg.lpSetupTemplateName = NULL; 
pdg.hPrintTemplate * NULL; 
pdg.hSetupTemplate * NULL; 
if UPrintDlgUpdg)) 
return FALSE; 


ShowMetrics(pdg.hDC); 

lpdvm * (LPDEVM0DE1G1obalLockCpdg.hDevMode); 
lpdvm->dmPaper$ize = DMPAPER_U$ER; 

1pdvm->dmPaperWidth = 2159; /* 8.5 * 254 */ 
lpdvm->dmPaperLength = 2794; /* 11 * 254 */ 
ResetDClpdg.hDC. lpdvm); 

ShowMetrics(pdg.hDC); 

DeleteDC(pdg.hDC); 

GlobalFree(pdg.hOevMode); 

GlobalFreeC pdg.hDevNames); 
return TRUE; 


void ShowMetrics(HDC hdc) 

jj 

/* -- Display the paper metrics for the printer. */ 
/*★*★★***★*★*★*★★*★*★***★★★*★***★**★★*******★*★★***★★★/ 
{ 

POINT pt: 
char szBuf[512]; 

Escapethdc. GETPRINTINGOFFSET. NULL, NULL, 
(LPVOID)ipt); 

wsprintf(szBuf, "VERTRES %d\n HORZRES *d\n" 

" PRINTINGOFFSET «d, *d)". 

GetDeviceCaps(hdc, VERTRES), 

GetDeviceCaps(hdc, HORZRES), pt.x, pt.y); 
MessageBoxtNULL, szBuf, "Paper Metrics", MB_0K); 

} 

/* End of File */ 


The first time ShowMetricsO is called, everything is well 
and good (if the default paper size is letter, you should 
see (2400, 3000) for the resolution and (75, 100) for the 
offset). The application then uses DMPAPER_USER to choose a 
standard paper size, 8.5" x 11". The subsequent call to 
ShowMetricsO gives random results. A typical set of num¬ 
bers can be as bizarre as (9095, 3566) for the resolution, 
and (18, 518) for the offset. 

The only work-around I know of is painful. You must 
call the DeviceCapabilitiesO function to obtain a list of 
supported paper sizes; match these up with the sizes 
specified by the predefined DMPAPER_XXXX constants in 
print.h; and use those constants to control the paper size. 

The big problem with bugs of this type is that you end 
up writing lots of code to work around a bug that occurs 
in only one of the hundreds of printers available for Win¬ 
dows. The more code you write, the higher the chance of 
introducing an error, or breaking some other printer 
driver. Also, you probably don't want to use two versions 
of the code (the simple one for 'good' printers, and the 
work-around for the 550C), since then you either have to 
explicitly check the driver name and version number to 
know which version of the code to run, or you need a 
way to determine that the simple method has failed and 
to use the complicated way. 

The problem with explicitly checking for a particular 
version of a printer driver is that you don't know when 
the bug will be fixed. So, for example, if your criterion for 
using the work-around is to test for a version of the 550C 
less than 4.0, and the bug is not fixed in the next release 
of the driver, your application will break when users install 
that new version. Conversely, if you don't perform the ver¬ 
sion check, and a subsequent version of the driver fixes 
the bug, than you will end up executing work-around 
code when you really could be executing the preferred 
version. It's not too bad in this case, since you can realize 
equivalent functionality either way, but in some cases 
your work-around code will be limited to a subset of the 
available driver functionality, to avoid tickling a bug in the 
desired functional area. 

I don't have a good answer for this dilemma. If you 
have a non-catastrophic test to see if the driver has failed 
using the preferred way, then my suggestion is to embed 
two versions of the code, selected by the outcome of the 
test. Otherwise, you may have no choice but to use the 
work-around for all versions of the driver, preventing your 
application's full use of the driver's functionality until after 
the manufacturer fixes the driver and you release a new 
version of your application. □ 
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The Dialog Editor Controls Pack 

Victor R. Volkman 


Introduction 

The Dialog Editor Controls Pack, by Simon Whiteside, is 
a set of Windows custom controls that you can position 
on your own application windows to create a built-in dia¬ 
log box editor. A dialog box editor implemented as a Win¬ 
dows custom control is a new concept and one that al¬ 
lows maximum flexibility in integration. To get up and 
running, all you have to do is load the custom controls 
and then call CreateUindouO once for the DLGEDIT_CLASS and 
once for the DLGPAL_CLASS. Figure 1 shows the dialog box 
editor with a work-in-progress in a scenario where the dia¬ 
log box control has been sized to fill the entire window. 

As a Windows developer, you've probably used dialog 
editors since your first day with the SDK. However, the 
Windows SDK Dialog Editor (dlgedit.exe) cannot be redis¬ 
tributed with your application. Furthermore, customers can 
be expected to balk at having to buy and install an SDK 
just to have dialog box editing capabilities. The Dialog Edi¬ 
tor Controls Pack lets you seamlessly integrate such capa¬ 
bilities. It includes Windows custom controls that provide a 
dialog editor user interface along with a corresponding 
message programming interface. 

A Dialog Editor Control and Palette Control 

Whiteside's pack provides two Windows custom con¬ 
trols to help you build dialog editors for your tools (see 
Figure 1). You can employ these Windows custom controls 


in many ways: from raw dialog definition editors ail the 
way up to code generators. The principal custom control is 
the 'Dialog Editor control' (or DLGEDIT). This custom con¬ 
trol has its own programming interface, which allows you 
to add or modify the controls it owns, it also has a user 
interface that allows the user to move and resize its controls. 


Dialog Editor Controls Pack vl.00 

Author 

Simon Whiteside, 164 Oxford Road, Windsor, 
Berkshire SL4 5DU, United Kingdom. 

Email: sdw@zara.demon.co.uk. 

Registration 

£30 (U.K.), approx. $50 in U.S. currency. 

Evaluation 

up to 30 days. 

Where to get it 

The oak.oakland.edu anonymous ftp server 
(Oakland University, Rochester, Michigan) 
in the / pub/msdos/windoHs3 directory as 
DLGED100.ZIP. 

Download it from: 

HAL 9000 BBS: +1 313 663 4173 or 

663 3959 speeds from 2400 to 28800 bps. 


Victor R. Volkman received a BS in Computer Science from Michigan Technological University. He has been a frequent contributor to 
Windows/DOS Developer's Journal since 1990. He is currently employed as Senior Analyst at H.C.I.A in Ann Arbor, Michigan. He 
can be reached by dial-in at the HAL 9000 BBS (313) 663-4173 or by Usenet mail to sy sop@hal 9k.com 












The pack also supplies a 'Palette control' (or DLGPAL) 
which understands the programming interface to the dia¬ 
log editor. You can use this control to provide a custo¬ 
mizable 'tool palette' from which the user can drag con¬ 
trols to be added to the dialog editor (see Figure 2). The 
palette control can handle any mix of up to TOO controls 
simultaneously. 

The controls are managed via Windows messages that 
use the structures and messages defined in dlgedit.h (sup¬ 
plied with the pack). This file also contains macros, similar 
to those in windowsx.h, that make sending the messages 
easier. Each class resides in its own DLL: DLGEDIT in 
dlgedit.dll and DLGPAL in dlgpal.dll. 

You can use LoadlibraryO to load the DLLs, or you can 
link to the import libraries dlgedit.lib and dlgpal.lib. The 
functions DeLoadO and DpLoadO initialize dlgedit.dll and 
dlgpal.dll, respectively. 

DLGEDIT Message Interface and Data 
Structures 

As mentioned above, the DLGEDIT control can be com¬ 
pletely managed through a message-level interface. Figure 
3 lists all of the messages supported by DLGEDIT. You can 
either call SendMessageO directly or else invoke a C macro 
that does this for you, as shown below: 


#define DeFindControl(hctl,flag,1param)\ 

SendMessagethctl,DE_FINDCONTROL.fi ag.lparam) 

The DEJDDCONTROL, DEJETCONTROLINFO, and DE_GETC0NTR0LINF0 
messages work with the complete definition of a control 
and so need more data than can fit in IParam and wParam. 
These three messages all pass a pointer to a CONTROLINFO 
structure in the IParam (see Figure 4). The CONTROLINFO struc¬ 
ture contains basic resource information such as location, 
size, control ID, style bits, and more. I will describe later 
how the DLGPAL control sends a DE_ADDC0NTR0L message 
each time the user does a drag-and-drop from the palette 
on to the dialog editor. The DLGEDIT control can handle 
up to 100 controls. 

The other messages specific to individual controls 
(DEJELETECONTROL, DE_GETFOCUSINDEX, and DEJINDCONTROL ) all 
operate on simple control IDs rather than CONTROLINFO 
structures. 

Some messages refer more to global parameters in 
DLGEDIT than to individual controls. DE_GETC0UNT returns 
the total number of controls. DE_SETGRID, DE_GETGRID, and 
DEJSGRIDON allow you to easily customize a grid overlay. 
The grid overlay makes it easier for the user to visually 
line up controls. You can force all new controls to align 
("snap' in CAD terminology) with grid marks by using 
DE_SETSNAP0N. You can discover the snap state with DE_ISS- 
NAPON. 
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Create Powerful Image Applications 

for 3MP, TIFF, FCX, GIF, TGA, and JFEG Images 


(► Load and save 

BMP/TIFF/PCX/GIF/TGA/JPEG 

Powerful grayscale and color 
image processing: brightness, 
contrast, sharpen, outline, 
equalize, matrix convolution, 
rotate, resize, and more 

Color reduction for fast and 
accurate display of 24-bit images 

)► Support for EGA/VGA/SVGA, 32K- 
and 16 million-color displays 

§► Scan b/w, grayscale, and color 
images with ScanJet scanners 

!► Print halftones, diffusion scatters, 

1 and color pictures 

fb Convert images between 1-, 8-, 
and 24-bit formats 

Convert color to grayscale 

P Includes a complete image 
processing application with C 
source 



Your Windows application can load and 
save BMP. TIFF. PCX. GIF. TGA. and JPEG 
files, control scanner and printer, and have 
powerful Image processing and color 
reduction for the very best Image display. 


Victor Image Processing Library 
for Windows (DLL), $295 

Victor Image Processing Library 
for DOS, supports Microsoft 
and Boriand C/C++ compilers, $195 

Call or fax to order 


314-962-7833 


C'Catenary Systems 


470 Belleview St Louis MO 63119 
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If Einstein had to make the choice he'd 
probably take a " hands-on" Object-Oriented 
C++ course for MFC, OWL and OLE from 

Leading Design! 


Experience and Learn 
Object-Oriented C++ with 
MFC* or OWL! DASIST 

Object computing is rapidly 1 WUNDERBAR! 
becoming the technique of choice 
for most major software developers. 

Today, 60% of Windows applications 
use objects. Tomorrow, Taligent, 

Chicago, Cairo, CORBA, SOM, Object 
Databases, enterprise computing with 
and without OLE wait for the unsuspect¬ 
ing programmer, all with new kinds of 
objects and “paradigms” in tow. 


Powerful Courses for 
Powerful Results 

To use objects most effectively, 
you must approach software develop¬ 
ment in a whole new way. Not only 
must you learn the syntax and features 
of your object language and develop¬ 
ment system, but you must think in 
an object-oriented way. 



NEW COURSE 
OLE 2 in 3 days. Build an OLE 2 
container and server. 

Call for Details! 


That is where Leading Design, the 
premier software consulting and training 
firm specializing in object technology, 
comes in. We have unparalleled 
experience training software develop¬ 
ment teams, ranging from Fortune 100 
companies to small businesses, in object 
technology and C++. 


Cut Your Object Learning 
Curve With Intensive 
Hands-On Training! 

Object-oriented C+ + mine Microsoft 
Foundation Classes or Borlands Object 

Windows Library spans five full days 
with four hours of instruction and four 
hours of intensive, hands-on labs every 
day. Participants will learn how to 
design and code industrial strength C++ 
Windows applications using MFC/OWL 
and the tools of Microsoft Visual C++ 
or Borland IDE depending on the course 
you select. 

Our training, mentoring and consulting 
customers include IBM, Microsoft, NCR, HP, 

TI, Wang Labs, Xerox, Intel, Pan Canadian 
Petroleum, Aldus, NEC, Word Perfect, Safeco, 
Chevron, Symantec and Boston University. 


Our 3 or 5 Day Courses 
Are Designed For: 

□ C and C++ programmers 

migrating towards Windows 

□ Programmers using C to 
develop Windows applications 

□ Developers involved in object- 
oriented Windows programming 
seeking a second opinion on key 
technology decisions 

□ Software designers and 
architects needing to understand 
object-oriented Windows 

OOA, OOD, OOP and OLE 2 

□ Technical managers responsible 
for hands-on object-oriented 
Windows software development 
and strategic direction 


LEADING DESIGN 
COURSES INCLUDE: 

Building a full scale 
application in 10-16 labs 
using C++, MFC or OWL 
and a valuable Object 
library. Plus, course 
software and manual. 


MONTHLY COURSES: 

■ SEATTLE ■ CHICAGO ■ BOSTON 

Please contact Vicky Lindgren for exact dates and locations. 

Prices for Courses: 
Object-Oriented C++ with MFC 

(includes introduction to OLE 2) 

or Object-Oriented C++ with OWL 

Each 5 day course is $1,500 per person 
New Course for OLE 2 
NEW 3 day course is $1,095 per person 

Group discounts available on all courses. 

Special "On-Site" group courses scheduled upon request. 




Leading design 

163 McGraw Place, Seattle. WA 98109 


Register Early! Call for Discounts! 1-800-355-9845 


5-DAY COURSE TOPICS INCLUDE: 


✓ Effective coding techniques to maximize the benefit of MFC or OWL classes 

✓ Practical methods to design object-oriented Windows applications efficiently 

✓ Strengths and weaknesses of key C++ features to avoid traps and blind alleys 

✓ Scaleable C++ coding procedures that are safe, reusable and easy to maintain 

----- — 

* 5 day MFC course includes introduction to OLE 2. 5 day OWL course does not support OLE 2. 



















































Figure 1 A Dialog Editor you can build 


The DE_SETTEST message switches the dialog editor con¬ 
trol into or out of test mode. In test mode, the entire set 
of controls becomes active, as if it were under the control 
of a standard Windows dialog box callback. Testing helps 
you examine the look and feel of a dialog before writing 
the support code. 


Neither DE_ALIGNCONTROLS nor DE_SIZECONTROLS is imple¬ 
mented in version 1.00. These messages are intended to 
act on groups of selected controls, but the current version 
supports only single selection rather than multiple selec¬ 
tion. 

DLGPAL Message Interface and Data 
Structures 

The dialog palette is designed to interact with the dia¬ 
log editor. It presents the user with a palette from which 
controls can be dragged and dropped onto the editor. 
When the user drops a control on the dialog editor, the 
palette sends the editor a DE_ADDC0NTR0L with the details 
stored in the CLASSINFO structure held for the item in the 
palette. 

Most dialog editing applications can work just fine with 
an essentially fixed palette. However, a rich message inter¬ 
face allows for dynamic reconfiguration of the palette (see 
Figure 5). The only message that you're required to use is 
DP_ADDCLASS. Each invocation of this message adds another 
control to the DLGPAL. 

The DP_ADDCLASS, DP_GETCLASSINFO, and DPJETCLASSINFO 
messages all use the CLASSINFO structure pointer as the 
IParam. The CLASSINFO structure (see Figure 6) is an abbrevi¬ 
ated version of the familiar CONTROLINFO structure used in 
the DLGEDIT control. 


ANNOUNCING 


ROBINHOOD 


REMOTE CONTROL ANY DOS APPLICATION FROM WINDOWS USING DDE 


COOPERATIVE PROCESSING 

You may know about our incomparable WINGate Developer’s 
Toolkit for peer-to-peer and client-server communications 
between VMs. . .using WINGate’s 36-function API, 
extensive DOS libraries and Windows DLL 
to create the transactions of your 
imagination for real-time 
integration of cooper¬ 
ating Windows and 
DOS applications. 


• LAUNCH AND TERMINATE ANY 
DOS PROGRAM. 

• SEND KEYSTROKES TO ANY 
DOS PROGRAM. 

• READ DATA FROM ANY DOS SCREEN. 

• WRITE DATA TO ANY DOS SCREEN. 


UN-COOPERATIVE PROCESSING 

Now, with the release 
of RobinHood, even the 
most obstinate, seemingly 
impenetrable DOS programs become 
“easy targets” for RobinHood and his band of 
merry Windows programs. 

You may have experienced the futility of trying to access 
vital information trapped within many DOS programs-rendered 
un-cooperative because of unavailable source code, programmers, 
documentation, time and/or finances. RobinHood, with classic ease, 
scales these barriers. It takes what it wants from the DOS programs... 
without their consent' 

FROM 

WINGate 

“The industry leaders in Windows-DOS communications” 

High Street Court, Suite 303, Morristown, NJ 07960 
l-800-9Ji6-Jf283 • 201-539-2727 • Fax 201-539-2838 
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The DP_FINDCLASSINDEX and DPJEMOVECLASS messages op¬ 
erate on an ordinal value, similar to a control ID, indicat¬ 
ing the logical position of a control in the DLGPAL. 

Last, DPJETCOUNT and DPJETITEMSIZE return the number 
of items currently on the DLGPAL and the dimensions of 
each item, respectively. All items in the DLGPAL are ex¬ 
pected to be squares of the same size square. 

Putting It All Together 

The Dialog Editor Controls Pack includes a complete C 
source sample application. The sample application begins 
in UinMainO by calling DpLoadO and DeLoadO to initialize 
the DLLs. Next, it creates the main window, which is 
where all controls will be appearing. 

Afterwards, it enters the familiar Get- 
MessageO and DispatchMessageO loop 
you might expect in any Windows 
application. 

The UM_CREATE event appears soon 
after and is dispatched to the applica¬ 
tion function OnCreateO. This function 
in turn creates a child window for the 
DLGEDIT control. This child window 
will be overlaid on the main window. 

OnCreateO also creates a separate 


pop-up window for the DLGPAL. This pop-up window can 
float anywhere on the screen and is sized precisely two 
icons wide by five icons tail (see Figure 2). 

Soon after UM_CREATE is processed, a UM_SIZE message 
appears and the application calls MoveUindowO to stretch 
the DLGEDIT control to overlay the entire main window. If 
you have other controls or data to display on the main 
window, you can size the DLGEDIT to fit a smaller portion 
of the window. Beyond UM_SIZE and UM_CREATE, you need 
only craft some small support functions for menu picks 
you may wish to support. For example, most dialog edi¬ 
tors use a 'Test' menu pick to toggle the dialog editor into 
a tryout mode. 
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Figure 2 ciose-up view of 
Palette Control (DLGPAL) 



Windows 

Self-Installing 

Executables 


Not just another installer! 


SIMPLE 


The Wise Installation Systems is a completely 

_ Windows based installation editor that creates 

professional setup programs in hours, not days. Create your installa¬ 
tions via drag and drop without writing a single line of code. Wise 
scans your programs for the VBXs/DLLs they reference, so you'll 
never forget to include the proper VBX/DLL again! Automatically 
compresses and splits your files across multiple floppy disks. 

True multi-language support, a single installa¬ 
tion script can contain up to 15 languages. 
Component based custom installations • A complete unistaller • Editing 
of autoexec/config • Adding device entries to system.ini • If/then else 
branching • Browsing for destination directory/program manager group 
Scanning disk for previous versions • Seralizing programs • User defined 
radio button dialogs • Reading environment/ini/registry values • Checking 
system for hardware/software configurations • Displaying multiple, trans¬ 
parent, scalable graphic images • Calling DLL functions • Controlling the 
installation via DDE/VB programs • And many more features! 

Special Introductory Price $129.00 
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Figure 3 Dialog Editor control messages 

Message 

Description 

DE ADDCONTROL 

Adds a control to the editor 

D E S ETCONTROLINFO 

Changes a control's data 

DE.GETCONTROLINFO 

Gets a control's data 

DE FINDCONTROL 

Finds a control 

DE DELETECONTROL 

Removes a control 

DE GETSELCOUNT 

Number of selected controls 

DE GETCOUNT 

Number of controls 

DE GETFOCUSINDEX 

Control with focus 

DE ALIGNCONTROLS* 

Aligns selected controls 

DE SIZECONTROLS 

Resizes selected controls* 

DE SETTEST 

Puts editor in test mode 

DE GETSEL 

Gets selected controls 

DE SETGRID 

Displays grid 

DE GETGRID 

Gets grid settings 

DEJSGRIDON 

Grid visibility state 

DE SETSNAPON 

Set snap-to-grid 

DEJSSNAPON 

Snapping state 

Notes: * indicates feature not implemented in version 1.00 
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HI 
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ijjjgl File Edit Search Run Options Window 


Write industrial strength business applications for the 
industry standard operating environment, Windows 3.11 
Applications which are intelligent, robust. Applications 
which release the full 32-bit power of your computers. 
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Directly programmable dialogs, menus & windows 
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multi-file program editor, project files, incremental and 
optimising compilers, and full Prolog predicate library. 
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The sample application includes source for two other 
handy utilities you'll want to incorporate: SaveDialogO and 
StyleO. SaveDlalogO lets you dump the contents of the 
D LG ED IT control to .dig file for easy incorporation into 
your application. Figure 7 shows the .dig file generated 
from the dialog box being edited in Figure 1. Although the 
sample application calls this from the 'File' menu 
( IDM_SAVE), you can put it on a toolbar or anywhere else. 

The StyleO function brings up a dialog box that pre¬ 
sents edit style flags. The style dialog box is somewhat 
specific to the type of the currently selected control. Using 
the style dialog, you can easily change any setting associ¬ 
ated with a control, including its dialog ID (see Figure 8). 


Figure 4 CONTROLINFO used in Dialog Editor 

messages 


typedef struct CONTROLINFO 
{ 

LPCSTR IpszClassName; 


/* address of registered class name */ 

LPCSTR IpszWindowName; 

/* address of window text */ 

DWORD dwStyle; 

/* window style */ 

int x; 

/* horizontal position of window */ 

int y; 

/* vertical position of window */ 

int nWidth; 

/* window width */ 

int nHeight; 

/* window height */ 

HWND hwndParent; 

/* handle of parent window */ 

int id; 

/* child-window identifier */ 

HWND hwnd; 

/* window handle of control */ 

BOOL bSelected; 

/* selection flag */ 

DWORD dwUser; 

/* user data for control */ 

JCONTROLINFO; 


typedef CONTROLINFO FAR * LPCONTROLINFO; 


Figure 5 Palette control messages 

Message 

Description 

DP.ADDCLASS 

Add an item 

DP GETCLASSINFO 

Get item info 

dp setclassinfo 

Change item 

DP FINDCLASSINDEX 

Find item 

DP REMOVECLASS 

Remove item 

DP GETCOUNT 

Number of items 

DP GETITEMSIZE 

Pixel size of item 


Figure 6 CLASSINFO used in Palette control 
messages 


typedef struct _CLAS$INFO{ 

LPCSTR IpszTitle; 

LPCSTR 1pszCIassName; 

LPCSTR IpszWindowName; 

HBITMAP hBitmap; 

DWORD dwStyle; 
int nWidth, 
nHeight: 

DWORD dwllser; 

KLASSINFO; 

typedef CLASSINFO FAR * LPCLASSINFO; 
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Documentation, Licensing, 
and Support 

Documentation for this pack is en¬ 
tirely contained in a standard Win¬ 
dows Help file (.hip). The help file is 
well-organized and includes full hy¬ 
pertext pointers for every message 
and data structure relevant to dialog 
editing. The help file is not intended 
to be an introduction to general us¬ 
age of Windows controls. The MS 
Windows 'Guide to Programming" 
(chapter 8) provides such an introduc¬ 
tion. 


Figure 7 Actual .DLG file generated from Figure 1 


finclude (windows,h> 

DIALOG_1 DIALOG 94,44,221,162 

STYLE DS_MODALFRAME I NSJOPUP I WS_CAPTION I WSJYSMENU 
CAPTION "Test Dialog" 

BEGIN 

CONTROL "Windows/DOS Developer’s Journal", 0, "STATIC". US GROUP IWS_VISIBLEISS RIGHT ISS SIMPLE!®, 51. 2. 142, 12 
CONTROL "1 Year Subscription *29", 0, "BUTTON", WS_TABSTOPIWS VISIBLE IBSJNUTORADIOBUTTON10 . 74 , 29, 106, 13 
CONTROL "2 Year Subscription *54", 0, "BUTTON", WS_TABSTOP|WS_VISIBLEIBS AUTORADIOBUTTON 10, 74. 43, 95. 16 
CONTROL "Subscribe!", 0, "BUTTON", WS TABSTOPIUS VISIBLEIBS_PUSHBUTTONI0, 60, 109, 50, 16 
CONTROL "Cancel", 0, "BUTTON", WS_TABSTOPIWS_VISIBLEIBS_PUSHBUTTON10, 122, 109, 50, 17 
CONTROL "Subscriptions", 0. "BUTTON". US_GROUP|WS_VISIBLEIBS.GROUPBOX|0, 53, 16, 127, 53 
CONTROL "Horiz Scroll Bar", 0, "SCROLLBAR", WS_TABSTOP|USJISIBLEISBS_VERTI0, 191, 10, 8, 97 
CONTROL "Combo", 0, "COMBOBOX", US TABSTOPIUS_VISIBLEI CBS .DROPDOWN 10, 54, 76, 126, 12 
CONTROL "VISA/Mastercard", 0. "BUTTON". US_TABSTOPI US VISIBLE IBS.AUTOCHECKBOX10 , 54 , 91, 128, 13 
END 


The Dialog Editor Controls Pack is 
a shareware product, which means 
that you can try it before you buy it. If you continue to 
use it beyond the 30-day evaluation period, you are ex¬ 
pected to register the product. This product displays no 
'nagware' dialogs that beg for registration. Only registered 
users may redistribute the runtime DLL as part of an inte¬ 
grated product, and registration entitles you to unlimited 
redistribution of the runtime DLLs. 

You can register the pack with a check or money-order 
for the sum of £30 U.K. This is approximately $50 at cur¬ 
rent U.S./U.K. exchange rates. If you must register in U.S. 
funds, please include an extra $7.50 to help pay currency 
conversion charges. Upon registration, you will receive up¬ 
dates at special rates from the author, who also promises 
technical support via Internet email for registered users. 
The author also can be contacted if special versions of the 
software are required. 


Combobox style 
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"Attributes 
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□ Border 
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® Not owner draw 
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"Scroll Bars 
□ Vertical 
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® Drop down 
O Drop down list 

□ Sorted 

G integral height 

□ OEM conversion 

□ Auto horizontal 

□ Vertical scroll always 

□ Has strings 


Qk ~| Cancel 


Figure 8 Editing the style of the selected control 


Conclusion 

For applications ranging from macro languages to full- 
scale CASE tools, developers have a significant need for 
incorporating basic dialog editing. Simon Whiteside's Dia¬ 
log Editor Controls Pack gives you a head start on the 
dialog editing functionality you need and spares you the 
task of reinventing the wheel. With the pack, dialog edit¬ 
ing can be launched from any application that supports a 
DLL interface. □ 



ST 


ADONIS 


Micro-Software 
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for DOS, Windows, NT, OS/2 

for MS C/C++, Visual C++, Turbo/Borland C/C++, 
Turbo/Borla7id Pascal (incl. Protected-Nbage) , IBM C/C++ 

SuperCom is the development tool for etecfeig serial communi¬ 
cation software. That means high data rfSbptty and highest trans¬ 
mission speed. The SuperCom librari^ta(i fast even in a multi¬ 
tasking operating system like Wind&Jlt Windows NT or OS/2. 

The same programming interf^e*Aised among different 
languages and operating s)®t|ffl|^ 

• Interrupt driven: transmission, receptiaU^MaWT • Language independent DLL (Windows, NT, OS/2) 

modem status. Up to 115,200 bps. which can be used for simultaneous transfers by 

• UARTS: 8250,16450,16550 FIFO, fc/ port address, applications, 

• Simultaneous COMJ..COM 36»*in!imited). • Multiserial board support (AST, ARNET, DigiBoard 

• Direct register programmingTBfeapSharing. pc/X, HOSTESS, STARGATE), Reduces loading of 

• Flow control: RTS/CTi D'S*»R;TON/XOFP and CPU through support of intelligent DigiBoard PC/Xe, 

user defined, ANSI/r%ytKaf PC/Xi boards (up to 112 ports' III). 

• Protocols: ASCII, XBgaflJkXMODEM/CRC, • Modem support, RS422/485 support. 

YMODEM, YMODEMRATCH ZMODEM, • Support for 286 DOS-Extender (e.g. PharLap) 

• Timer, Ctrl-Break and EJteption handling. • No resident drivers'. Just link the LIB. No Royalties. 

• Multitasking support (Windows, NT, OS/2) • FREE technical support. FREE demo 

• Protected Mode Interface, 386-Technology. • Full source code (C or Pascal and optimized ASM). 

• User Event Routines under DOS and Windows. • SuperCom++ (C++ or Pascal OOP) included. 

Under Windows user can even post messages to • Protected Mode Interface (Windows) included, 
the application using PostMessage . 

C/C++ or Pascal package for DOS only $299 
C/C++ or Pascal package for Windows. OS/2 or NT each $399 
C/C++ or Pascal combo pack for DOS+Windows only $528 
C/C++ or Pascal combo pack for Windows+NT only $598 
C/C++ combo pack for DOS+Windows+OS/2 only $799 
C/C++ combo pack for DOS+Windows+NT only $799 
C/C++ combo pack for DOS+Windows+OS/2+NT only $999 

'Under DOS and Windows 3.x _ VISA, MC, COD, Check accepted. 
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■ Practical C++ 


Creating WUIMAN Properties 



Ron Burk 


Send reader mail to: 
wdletter@rdpub.com. 



Visual C++ vl .5 
Borland C++ v4.02 
Symantec C++ v6.1 


This is number thirteen in a series of columns about the design and imple¬ 
mentation of WUIMAN (a Windows User Interface MANager). This installment 
discusses some compiler bugs I ran into and then demonstrates my first at¬ 
tempt at creating a derived WUIMAN property. 

Startup Code Woes with Borland 

This project continues to be a lodestone for bugs, and I wasted much of my 
limited programming time this month on a couple of compiler bugs I had not 
seen before. The first bug happened while I was using Borland C++ 3.0. I 
usually try to use the latest version of any compiler (v4.02 in this case), but 
compilers come on CD-ROMs these days, and I had no easy way to install the 
new version on my laptop, so I just kept putting it off. One day, after doing a 
lot of work on the code offsite on my laptop, I started getting serious GP faults. 
They occurred before LibMainO was called, which made them somewhat more 
unpleasant to debug. 

Getting a GP fault in WUIMAN always gives me a sinking feeling because 
I've used assertions extensively in the code and it now takes a certain amount 
of talent to inject an error that is not quickly caught by an assertion. After 
some hours of tedious debugging, however, I managed to discover that it was 
a Borland bug which can be described fairly simply. Suppose class TSymbol has 
a constructor that take a single argument of type TString. Further, suppose that 
class TString has a constructor that takes a character pointer for an argument. 
You could then create a static instance of class TSymbol with a statement like 
this at file scope: 

TSymbol IfStatementC’if") 

In this case, the compiler has to generate startup code that creates a temporary 
object of type TString, initialized with 'if', and then pass that TString object to 
IfStatement s constructor to initialize it. The compiler also has to destroy the 
temporary TString after the TSymbol is initialized. Unfortunately, in this situation, 
Borland generated code that popped the temporary TString off the stack before 
calling its destructor! I could not construct any workaround for this bug, but 
there was a modicum of relief that the bug was not in my code. 

That led to my next sinking feeling. What if this bug was fixed in Borland 
C++ v4.02 and I had wasted all this time because my laptop did not have the 
latest version? In fact, that appeared to be the case, as I disassembled the code 


Ron Burk is the editor of Windows/DOS Developer's Journal and has been a program¬ 
mer for 12 years. You may contact him at Burk Labs, P.O. Box 3082, Redmond, WA 
98073-3082. CIS: 70302,2566. Internet: ronb@rdpub.com (“ . . . luunetlrdpublronb”). 
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generated by Borland C++ 4.02 for this situation, and it 
was correct. I learned my lesson, and I won't postpone 
ferrying the latest compiler versions onto my laptop any 
more. 

Symantec's GP Fault 

I mainly work with Borland C++, but I periodically 
switch to Visual C++ and Symantec C++ (I'm almost ready 
to start supporting Watcom as well) to verify that my code 
is portable and works with multiple compilers. Last month, 
I had already turned my column in before doing a cursory 
check with all the other compilers. Usually, if I hit any 
problems, I can make a minor adjustment to the code be¬ 
fore it gets distributed. 

Imagine my surprise when I switched to Symantec C++ 
and started getting GP faults from the compiler, no matter 
what WUIMAN source file it compiled! After some consid¬ 
eration, I decided I must have a system configuration 
problem, so I made a little 'Hello World' program - but it 
compiled with no GP fault. More cogitation led me to the 
conclusion that the problem must lie within some header 
file that all my WUIMAN files included. At the same time, I 
remembered that Symantec C++ has a '-v' option that 
makes the compiler spit out information that shows how 
far it is into the code. With that in mind, I was able to 
narrow the problem down. I finally created the tiniest file I 
could that demonstrated the problem. If you place the 
code shown in Figure 1 into a file and compile it with 
Symantec's command-line compiler, the result is a GP 
fault. Walter Bright of Symantec reports that this is a 
known bug slated to be fixed in an upcoming release. I 
managed to come up with a different arrangement of the 
same macro that the compiler did not die on, so this 
month's code should still manage to work with Symantec 
C++. I also discovered that I am behind on my Symantec 
C++ version, as there is a CompuServe patch to move the 
compiler and libraries to version 6.11. In this case, how¬ 
ever, having the newest version would not have fixed my 
problem. 

On to WUIMAN 

Despite all the time wasted on compiler bugs, I did 
manage to push WUIMAN a bit closer to doing something 
useful. As described two months ago, WUIMAN is divided 
into a portable, system-independent kernel and a system- 
specific environment interface that defines user interface 
elements, such as windows, menus, and so on. This 
month, I worked on creating my first environment inter¬ 
face property, one for representing Windows colors. I ex¬ 
pect that many environment interface objects that I create 
(e.g., menus, windows, buttons) will need a color property, 
and this object will handle that for all of them. 


Creating a new WUIMAN property involves deriving a 
new C++ class from one of the kernel's C++ property 
classes. I made a fairly rudimentary color property class, 
but it provides a good example of the steps involved in 
creating any new WUIMAN property. 

1: Choose the Base Property Class 

The WUIMAN kernel provides four base data types for 
creating new properties; the names of these classes are 
TUuilntProperty, TUuiLongProperty, TUuiDoubleProperty, and 
TUuiStringProperty. These base classes contain and man¬ 
age the actual property data, which must be either an int, 
a long, a double, or a character string. You could actually 
just use TUuiStringProperty for everything, since all the 
other types can be represented as strings. However, these 
classes also support 'binding,' allowing a WUIMAN object 
to specify, for example, that a TUuilntProperty should actu¬ 
ally modify an int within the WUIMAN object itself, rather 
than within the property object. Thus, using the most 
natural representation for a particular property can make 
life easier for WUIMAN objects that use the property. 

A Windows color is a structure of type COLORREF, which 
happens to be compatible with a C++ long. Therefore, my 
new class (called TUuiColorProperty) inherits from TUuiLong- 
Property. WUIMAN objects that use my new object will be 
able to bind it to a variable of type COLORREF in their own 
classes. w_attr.h (Listing 1) shows the declaration for the 
new class. Note that it contains a static variable of type 
TUuiRegister, which will register the new class at startup. 
You pass the constructor for this variable a string contain¬ 
ing the name of the class and a pointer to a particular 
function (which is described next). 

Also notice that the declaration of TUuiColorProperty 
does not contain any variable of type COLORREF. TUuiLong- 
Property already contains a variable of type long (or a 
pointer to such a variable, if this is a bound property), and 
that is where the COLORREF will reside. In exchange for 
sometimes clumsy access to the data that represents the 
property, TUuiColorProperty is relieved of the work of im¬ 
plementing data binding, data persistence, attribute inheri¬ 
tance (described in earlier columns), and so on. TUuiLong- 
Property manages all these details. 

2: Define the ClassConstructorO 

As described in earlier columns, all WUIMAN objects 
are created by cloning some existing object. That means 
that a master object of type TUuiColorProperty must be cre¬ 
ated very early, before any WUIMAN objects that use this 
property are created. No knowledge of environment inter¬ 
face classes is compiled into the WUIMAN kernel, so it 
cannot simply use the new operator to create, for example, 
the master TUuiColorProperty object. Instead, I must supply 
TUuiRegister with a pointer to a function that creates and 






returns a pointer to the first copy of THui Co! orProperty, all 
other instances of THuiColorProperty will be cloned from 
that one. 


Figure 1 Producing a GP fault in Symantec C++ 


#include <assert.h> 

extern void AssertionFailurefchar *File, int LineNumber, 

char *Text): 

#define Y(e) (e ? (void)0 : AssertionFai1ure(_FILE_, _LINE_. #e)) 

#define X(x) Y(x) 

int Footchar *x) 

{ 

X(x); 

} 

/* End of File */ 


Listing 1 w_attr.h — Declaration for the color 
property 


// w_attr.h - declarations for useful Windows attributes 


#ifndef W_ATTR_H 
YMefine W_ATTR_H 

#if !(defined(JNC_WINDOWS) II definedi_WIND0WS_H)) 

#i nclude <windows.h> 

#endif 

#if !defined(WUIOBJDB_H) 

#include "wuiobjdb.h" 

#endif 


Listing 1 continued 


// TWuiWindows 


class TWuiColorProperty : public TWuiLongProperty 
r 

public: 


TWuiColorProperty(const TWuiName ObjectName, COLORREF *Address=0); 

virtual AWuiObject 

*C1onefconst TWuiName NewName, 


int Depth=0); 

virtual void 

Copyfconst AWuiObject ‘Other, 


int Depth); 

virtual TWuiName 

ClassNameO const; 

virtual TWuiName 

ParentClassNameO const; 

virtual int 

IsAfconst TWuiName Class, 


const TWuiName Method=(char *)0); 

virtual long 

GetCTWuiPath Path, TWuiArgs *Args, 


char ‘Buffer, size t MaxLength); 

virtual long 

SettTWuiPath Path, TWuiArgs ‘Args, 


const char ‘Buffer); 

static AWuiObject *ClassConstructor(const TWuiName Name); 

}; 

static TWuiRegister RegisterTWuiColorProperty( 

"p_Color”, TWuiColorProperty::ClassConstructor); 

f/endi f 


/* End of File */ 
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As you can see in w_attr.c (Listing 2), my ClassConstruc¬ 
torO does nothing but allocate a new TUuiColorProperty 
object and return its address. If your class requires any 
startup initialization, this is the place to do it. in particular, 
it is important to understand that due to the initialization 
order problem (described last month), you cannot count 
on any static object constructors having been called at the 
time your ClassConstructorO is called. The place where 
this condition is most likely to bite you is with TUuiName 
objects. Notice that I defined the class name in u_attr.c 
(Listing 2) like this: 

const char *C_TC0L0RPR0PERTY = "p_Color"; 
rather than like this: 

const TWuiName C_TCOLORPROPERTY("p_Color"); 

The reason is that the latter statement defines a variable 
that requires a constructor, and i have no way of ensuring 
that that constructor will have been called by the time my 
ClassConstructorO is invoked, since C++ does not guaran¬ 
tee any particular order of initialization for independent 
modules. 

3: Define the Constructor 

Defining the TUuiColorProperty constructor is easy. It 
gets passed a name and, optionally, an address of a vari¬ 
able to bind to. It just has to pass those arguments on to 


Listing 2 Code to implement the color property 


// w_attr.h - definitions for useful Windows attributes 

linclude <commdlg.h> 

♦include <string.h> 
linclude <stdio.h> 
linclude "wuiman.h" 
linclude "wuierror.h" 
linclude "w_attr.h" 

const char *C_TC0L0RPR0PERTY = "p_Color"; 


AWuiObject *TWuiColorProperty::ClassConstructor(const TWuiName Name) 

{ 

return new TViuiColorProperty(C_TC0L0RPR0PERTY); 

} 

TWuiColorProperty::TWuiColorProperty( 

const TWuiName ObjectName, COLORREF *Address) 

: TWu1LongProperty(0bjectName. (long *)Address) 

{ MEMBERASSERTO; 

DefineMethod(MJDITATTR); 

) 

AWuiObject *TWuiColorProperty::Clone(const TWuiName NewName, int Depth) 
{ MEMBERASSERTO; 

AWuiObject ‘Result = new TWuiColorProperty(NewName): 
if(Result == NULL) 
return Result; 
else 

{ 

Result->Copy(this. Depth); 
return Result; 

) 

} 

void TWuiColorProperty::Copy(const AWuiObject ‘Other, Int Depth) 

( MEMBERASSERTO; 

TWuiLongProperty::Copy(0ther, Depth); 

} 

TWuiName TWuiColorProperty:;C1assName() const 
{ MEMBERASSERTO; 
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TUuiLongProperty which does all the hard work. You do 
have to cast the COLORREF pointer to a long pointer, which 
is what TUuiLongProperty expects. 


Listing 2 continued 


return C_TCOLORPROPERTY; 

) 

TWuiName TWuiColorProperty::ParentClassName() const 

{ MEMBERASSERTO; 
return TWuiLongProperty::ClassName(); 

} 

Int TWuiColorProperty::IsA(const TWuiName Class. 

const TWuiName Method) 

{ MEMBERASSERTO; 

1 f(Class == CJC0L0RPR0PERTY || Class == CJLONGPROPERTY) 
{ 

if(Method == "") 
return TRUE; 

else if(GetAttribute(Method) I* NULL) 
return TRUE; 
else 

return FALSE; 

) 

else 

return TWuiLongProperty::IsACClass. Method); 

} 


long TWuiColorProperty::Get(TWuiPath Path. TWuiArgs *Args. 

char *Value, s1ze_t MaxLength) 

{ MEMBERASSERTO; 

1f(AWuiObject::TraceFlag) 

TraceCTWui Col orProperty ::Get", Path. Args); 
if(Args != NULL) 

{ 

1f(Args->AttributeName() ** M_EDITATTR) 

{ 

CH00SEC0L0R ColorInfo; 

COLORREF Custom[16]; 
memset(&Custom, 0. sizeof(Custom)); 
memsetUColorlnfo, 0. sizeof(Colorlnfo)); 

Col orInfo.1StructSize = sizeof(Colorlnfo); 

Col orInfo.Flags = CC.RGBINIT; 

Col orInfo.1pCustColors = Custom; 

// default color Is our current value 
Colorlnfo.rgbResult = PropertyValueO; 

1f(ChooseColor(&Colorlnfo) == TRUE) 

{ 

char StringValue[64]; 

sprintf(StrlngValue. "Xld", Colorlnfo.rgbResult); 
char MyName[TWuiName::MAXNAHE+1]; 
this->Name().GetName(MyName); 

return WUIMAN_Set(Path.AbsolutePath(), MyName. StringValue); 
} 

else 

return FALSE; 

} 

} 

return TWuiLongProperty::Get(Path. Args, Value. MaxLength); 

} 

long TWuiColorProperty::Set(TWuiPath Path. TWuiArgs *Args, 

const char *Value) 

{ MEMBERASSERTO; 
if(AWuiObject::TraceFlag) 

Trace("TWuiColorProperty::Set", Path. Args); 

1 f(Args != NULL && Args->Attr1buteName() I* NaraeO) 
return TWuiLongProperty::Set(Path, Args. Value); 

char *End; 

long Number = strtol(Value. &End, 0); 
if(End == Value II *End != '\0*) 

{ 

DEBUG_ERR0R("Not a legal value for a color" 

" attribute: 'Xs'", Value); 
return WUIMAN_ERR_SET_BAD_INTEGRAL; 

) 

if(Number & 0xFF000000L) 

{ 

DEBUG_ERR0R("Not a legal color value: ’Xs’", Value); 
return WUIMAN_ERR_SET_BAD_INTEGRAL; 

} 

return TWuiLongProperty::Set(Path, Args, Value); 

} 


/* End of File */ 
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The only statement in my TMuiColorProperty constructor 
is a call to DefineMethodO. Like any WUIMAN object, WUI- 
MAN property objects get passed a variety of messages 
from the outside world, via the MUIMAN_Get() and UUI- 
HAN_Set() functions. A WUIMAN object makes its willing¬ 
ness to handle a particular message known to the world 
by owning a method attribute of the same name. As 
usual, Th/uiLongProperty handles as much default behavior 
as possible, so TMuiColorProperty does not explicitly have 
to handle standard messages such as object deletion and 
so on. However, there is one optional message that WUI¬ 
MAN properties may decide to take on, and that is the 
standard M_EDITATTR message (defined as 'm_AttributeEdit'). 
If your property supports this method, it means that your 
user interface allows the user to edit your property di¬ 
rectly. 

In this case, I want users to be able to edit any color 
property of any WUIMAN object via the standard Choose 
Color common dialog box. I publicize my willingness to 
handle the necessary M_EDITATTR message by defining a 
method of that name in the class constructor. This is op¬ 
tional; however, if your property does not handle this 
message, then the user can only edit your property as a 
character string. In this case, that would mean the COLORREF 
would be converted to a decimal integer string, which is 
an unacceptably difficult way to select a color. 


4: Implement the "Mechanical" Functions 

Several member functions shown in u_attr.c (Listing 2) 
are so simple and invariable that they can be mechani¬ 
cally generated. CloneO and CopyO are two such functions. 
These two functions represent a fairly classic approach to 
implementing 'virtual constructors' in C++. The WUIMAN 
kernel must clone objects that it knows nothing about, 
and these virtual functions make that possible. Notice that 
even though it is implied that cloning may involve cloning 
children of the object, no code is supplied to do that. 
Once again, TUuiLongPropertyO handles the difficult details, 
this time in the call to TUuiLongProperty: :Copy(). 

Two more very easy functions are ClassNameO and Par- 
entClassNameO. They just return the name of this object's 
class and parent class, respectively. These allow external 
tools to inspect the object hierarchy of any particular WUI¬ 
MAN hierarchy. 

5: Implement the IsAO Function 

The IsAO member requires little code, but a lot of 
thought; it is crucial for allowing user interface inheritance. 
This function answers the question 'How compatible are 
you with your parent classes?' If you pass IsAO just the 
name of a class, it should return TRUE only if it is a strict 
superset of that class, supporting all of the same opera¬ 
tions. If you pass IsAO the name of a class and the name 
of a method, it should return TRUE only if it implements 
that particular method in a compatible way. 
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In this case, a TUuiColorProperty is not a complete su¬ 
perset of a TUuiLongProperty, for the simple reason that a 
Windows color is a 24-bit entity, while a long supports 32 
bits. Therefore, TUuiColorProperty::IsA() replies FALSE when 
asked about complete compatibility. However, it does sup¬ 
port all of the operations of TUuiLongProperty (indeed, it de¬ 
pends on that class to implement nearly all of them). This 
is where the logic shown in w_attr.c (Listing 2) for the 
IsAO function arises. 

6: Implement the GetO Function 

The outside world manipulates WUIMAN objects via 
two functions: UUIMAN_Get() and UUIMAN_Set(), which even¬ 


tually result in calls to virtual functions in WUIMAN objects 
named GetO and Set(). The former is used for all meth¬ 
ods, such as 'm_AttributeEdit', so TUuiColorProperty:: GetO 
contains the code to allow users to interactively choose a 
color. 

The Windows API function ChooseColorO provides the 
user interface. Figure 2 shows the result of the following 
function call: 

WUIMANJSet("/.p_color", "m_AttributeEdit",NULL, 0); 

TUuiColorProperty:GetO passes in a default color equal to 
the current value of this color property; TUuiLongProp¬ 
erty: :PropertyValue() is a convenient 
way to obtain that value. In this rudi¬ 
mentary implementation, I made no 
provision for the 16 custom colors 
that the dialog supports, so they are 
all black. 

An interesting thing happens after 
ChooseColorO returns with a new 
color - the code calls UUIMAN_Jet() to 
assign the new variable. Clearly, this 
is an extremely roundabout way to 
assign a value to a data member in 
the current object. In fact, though, 
TUuiLongProperty does not provide di¬ 
rect write access to the underlying 
long value. However, I could have at 
least called TUuiLongProperty: :Set() 
with the appropriate arguments to 
get the job done. Why didn't I? 

The answer is that WUIMAN is at 
heart a big tree, and it is always as¬ 
sumed that information flows from 
the root to the branches. If TUuiColor¬ 
Property allowed the user to directly 
tinker with a property value without 
going through the hierarchy, that as¬ 
sumption would be violated. The 
problems that could cause in this 
case are easy to imagine. Suppose I 
have a WUIMAN menu object that 
has, as one of its properties, a TUui¬ 
ColorProperty object. If any changes 
are made to that object, the menu 
object needs to know, since it may 
need to redraw itself (with a new color, 
for example). When properties allow 
the user to edit them directly, they 
must use UUIMAN_Set() to alter their 
own value, so that intervening objects 
have a chance to react to or even, in 
extreme cases, disallow the change. 

7: Implement the SetO 
Function 

The SetO function will get called 
whenever this property's value is to 
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change. For properties, the only thing 
the Set() function has to do is im¬ 
pose any additional restrictions on 
the value that the parent class does 
not have. In this case, TUuiColorProp- 
erty only supports 24-bit values, 
while TUuiLongProperty supports 32 
bits. Therefore, the Set() function 
checks for a valid string and either 
returns failure or passes the message 
on to TUui LongProperty: :Set(), which 
handles a great many details, such as 
saving the value to disk if the user 
has marked this as a persistent prop¬ 
erty, propagating the value to other 
objects if the user has marked this as 
an inheritable property, and so on. 


Summary 

One goal in designing the WUI- 
MAN kernel was to make it as easy 
as possible to define new objects and 
properties. Whether or not I suc¬ 
ceeded depends on your point of 
view. There are a lot of member 
functions to write in TUuiColorProperty, but most of them 
could easily be generated mechanically. 

This month's code disk has the complete WUIMAN 
source for the project to date, including code from past 
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■ Tech Tips 



Edited by 
Leor Zolman 


Please send us your best tricks and 
hacks - those clever pieces of code to 
make things work the way they 
should! You'll receive at least $50 for 
each tip that we print. 

Send your submissions: 

- via the Internet to: 
leor@bdsoft.com 

- from CompuServe to: 

INTERNET :leor@bdsoft.com 

- or by regular mail to: 

Leor Zolman 

74 Marblehead Street 
Noth Reading, MA 01864 


Extending File Manager, 
A Mini Screen Generator, 
and a Messagebox Bug 


It is time again, faithful readers, for me to make my periodic call for Tech Tips con¬ 
tributions. I guess this must be what it's like for those employees of public radio and TV 
stations when "Beg-a-Thon" time rolls around again: “Oh noooo, do we HAVE to lec¬ 
ture people about why they should contribute to the station? Don't they know that 
programming is made possible by audience contributions?' 

Well, around here, the programming IS audience contributions! And, we even pay 
you cash money (or, if you prefer, a subscription extension), an average of $100 per 
tip, to show our appreciation for your taking the time to pretty-up that code (we know 
what state it was in before you prepared it for publication!). 

Tired of seeing the same old names in this column? Give 'em some competition, 
and send in your Tip for publication. If possible, please submit it in electronic form - 
floppy disk, Internet (leor@bdsoft.com), or CompuServe (71514,1365 - but please no¬ 
tify me via Internet that you've uploaded to CIS, since I don't log in to CIS all that often 
- and please provide a complete, compilable example to illustrate your Tip, including a 
makefile if possible for non-trivial apps. 

This year, I finally made a sizable contribution to my local NPR radio station, as a 
way of making up for all my years of “freeloading ." Please consider enriching this col¬ 
umn with one of those pearls of wisdom from your valuable programming experience, 
and you'll be helping to keep these promotional announcements where they belong ...on 
the radio! 

Now, back to our regularly scheduled column! 


Leor Zolman is a consultant specializing in C programming training, an instructor on 
UNIX topics for Boston University's Center for Information Technology, and "Tech Tips~ 
editor for Windows/DOS Developer's Journal. His book, Illustrated C, was publish¬ 
ed in 1992. He may be contacted at 74 Marblehead St, North Reading, MA 01864. 
Internet address: 1eor@bdsoft.com. 
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Customizing File Manager 


Tom Nelson 
Lansing, Ml 


Windows File Manager (FM) is sometimes placed in 
service as a main operating shell. Some programmers may 
find it useful as a 'poor man's' development environment 
as well, especially if you typically work on smaller pro¬ 
jects. Technical end users can also customize and extend 
FM's capabilities as an operating shell by building an ex¬ 
tension DLL that FM loads at start-up. 

At a minimum, an extension DLL incorporates code 
that supports a customized extension menu that appears 
as part of FM's main menu bar. The extension code proc¬ 
esses events and extension menu commands received 
from FM, but can also send messages to retrieve data on 
FM's status. Table 1 summarizes these message and event 
types. 

examp.c (Listing 1) presents code for a skeleton DLL 
that demonstrates the basics of getting an extension up 
and running. The only required procedure in an extension 
DLL is FMExtensionProcO. This function receives all exten¬ 
sion menu commands and FM event notifications. To get 
the extension to load successfully, your extension must 
process the FMEVENT_LOAD message correctly which involves 
initializing an FMS_L0AD structure (Figure 1) with the name 
and handle of your extension menu. You can specify the 
layout of the extension menu in an .rc file or use Create- 
PopupHenuO dynamically (possibly using setup strings from 
an .ini file). All extension menu command IDs must be in 
the range of 1 to 99. FMS_L0AD also contains a menu 'delta 
factor* that your extension should assign to a global vari¬ 
able. Since FM can load up to five extension DLLs, FM 
assigns each extension a delta factor (delta + menujd) that 
separates its menu items from other extension items and 
FM's own menu items. The delta factor is mainly for FM's 
internal use; FMExtensionProcO receives extension com¬ 
mands without the delta factor added to them. 

To load the extension, FM looks in the [AddOns] sec¬ 
tion of winfile.ini, as, for example: 

[AddOns] 

MyExtenslon=C:\WINDOWS\EXAMP.DLL 



(...other extensions...) 


The monthly code disk for this issue contains a more 
comprehensive example that goes beyond the usual tech¬ 


niques for building an extension DLL (see the table of con¬ 
tents page for online source code information). The exam¬ 
ple is too extensive to describe fully here, so I will only 
touch on a few of its more important features. It too has 
an extension menu that you can access from FM's main 
menu bar, but you can also activate that menu as a floating 


Figure 1 Layout of FMS_LOAD initialization struct 

Type 

Name 

Description 

DWORD 

dwSize 

Sizeof this FMS LOAD object. 

CHAR 

szMenuName 

Name of extension menu to appear 
on File Manager's menu bar. 

HMENU 

hMenu 

Extension menu handle. 

UINT 

wMenuDelta 

Value passed to extension at load 
time. Identifies this extension and its 
menu items for FM. 

An extension must initialize the first three items. 


Listing 1 

examp.c — Skeleton DLL code 

/*. 

* LISTING 1 


* Filename: 

examp.c 

* Summary: 

File Manager extension DLL. 

* 

skeleton template 

* Author: 

T.W. Nelson 

* Compiler: 

BCC++ 4.0 

* Compile options: 

DLL, large model. C++ compile 





♦include <wfext.h> 

/* ♦includes windows.h */ 

extern "C" { /* descramble for C++ compile.... */ 

LONG WINAPI FMExtensionProc(HWND. WORD. LONG); 

} 

char szMenuT1tle[] = 

"Eixample"; 

WORD wDelta; 

/* menu delta-factor */ 

HINSTANCE hFMinst; 

/* FM instance handle */ 

HINSTANCE hEXinst; 

/* DLL instance handle */ 

HTASK hFMtask; 

/* FM task handle */ 

HWND hFMwnd; 

/* FM window handle */ 

HMENU hFMmenu; 

/* FM’s main menu */ 

HMENU hExMenu; 

/* our extension menu */ 

char msgBuf[200]; 


/* Menu ID numbers.. 

... */ 

♦define IDM CALC 

1 

♦define IDM WINSIGHT 

2 

♦define IDM DRIVE 

3 

♦define IDM API 

4 

♦define IDM ABOUT 

5 





int CALLBACK LibMain( HINSTANCE hinst, WORD wSeg. 


WORD wHeap, LPSTR cmdline ) 

/* Although LibMainO isn’t really needed. It 

* provides a portable method of retrelving the 

* module’s Instance handle w/o knowing the name of 

* the extension for call to GetModuleHandleO.... 


























popup menu from inside any application by clicking the 
right mouse button. The extension also allows you to 
change FM's own menu by adding new items or modify¬ 
ing the action of existing items. For example, it modifies 


FM's 'Run' command to invoke an "Open File' common 
dialog box that filters only executable files. If you've se¬ 
lected a file in FM's directory or Search Results window, 
that file appears in the dialog box, where you can type in 


Listing 1 continued 


*/ 

AppendMenu( hmenu. MF STRING, 

hEXinst * hinst; 

IDM_API, "Windows API &Help" ); 

AppendMenuC hmenu, MF_STRING, 

return 1; 

IDM ABOUT. "iAbOut" ); 

) 

return hmenu; 

int CALLBACK WEP( int exitType ) 


i 

LONG WINAPI .export 

/* Not really needed, but added here to let 

FMExtensionProc( HWND hwnd, WORD wMsg, LONG IParam ) 

* MessageBeepO indicate when FM unloads the 

( 

* DLL (maybe prematurely). 

switch ( wMsg ) { 

MessageBeep(O); 
return 1; 

case FMEVENT.LOAD: 

/* Initialize the FMS LOAD struct passed In 

i 

* IParam and do other setup stuff. FM unloads 

HMENU SetupExtensionHenu(void) 

* the module immediately if FMS.LOAD is not 

* initialized to its satisfaction (NOTE: won’t 

i 

* call FMEVENT UNLOAD in that case) . 

/* Create the extension menu. This can be done 

*/ 

* either dynamically, as here, or by loading a 

wDelta = (( LPFMS LOAD) 1Param)->wMenuDelta: 

* menu resource with LoadMenuO. 

(( LPFMS LOAD) 1 Param)->dwSize = 

*/ 

sizeof ( FMS LOAD); 

HMENU hmenu = CreatePopupMenuO: 

1 strcpy ((( LPFMS.LOAD) 1Param)->szMenuName. 

szMenuTitle ); 

AppendMenu( hmenu. MF STRING. 

hExMenu = SetupExtensionMenuO; 

((LPFMS_LOAD) 1Param)->hMenu = hExMenu; 

IDM CALC. "iCalculator" ); 

hFMwnd = hwnd; /* make global copy */ 

AppendMenu( hmenu. MF STRING, 

hFMinst = GetModuleHandle( "winfile.exe" ); 

IDM WINSIGHT. "iWinSight" ); 

hFMtask = GetWindowTask( hwnd ); 

AppendMenu( hmenu, MF_STRING, 

IDM.DRIVE, "iDrive Info" ); 

return (LONG) TRUE; 
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additional parameters. It also extends this feature to 'bind' 
or associate a selected file with any application you run 
from the extension menu. The selected file becomes a 
command-line parameter for the application you want to 


run, and no dialog box appears (unless you didn't select a 
file). Finally, the extension also emulates keyboard accel¬ 
erators, either for items in your extension menu or for any 
of FM's existing menu items. 


Listing 1 continued 



case FMEVENT UNLOAD: 

"Total* Xld bytes\n" 

"Volume* Xs\nSharePoint= Xs\n", 


/* Do shutdown duties, such as releasing any 

info.szPath. info.dwFreeSpace, 


* resources allocated during setup.... 

info.dwTotalSpace. info.szVolume. 


*/ 

info.szShare ); 


DestroyMenu( hExMenu ); 

MessageBox( hFMwnd. msgBuf, 


break; 

"Drive Info". MB_0K ); 


case FMEVENT SELCHANGE: 



break; 

break; 


case FMEVENT INITMENU: 

case IDM API: 


break; 

WinHelp( hFMwnd. "bwinapi.hip". 


case FMEVENT USER REFRESH: 

HELPJNDEX, NULL ); 

break; 


break; 

case IDM CALC: 

case IDM.ABOUT: 

MessageBox( hFMwnd. "File Manager Extension". 


WinExect "calc". SW SHOWNORKAL ); 

"About". MB OK ); 


break; 

break; 


case IDM WINSIGHT: 

default: 


WinExec( "winsight", SW SHOWNORMAL ); 

break; 


break; 

i 


case IDM DRIVE: { 

return 0L; 


FMS.GETDRIVEINFO info; 

i 


SendMessage( hFMwnd. FM_GETDRIVEINFO, 0. 

/*.EOF . */ 


(LONG) (LPFMS_GETDRIVEINFO) iinfo ); 
wsprintf( msgBuf. 

"Path= Xs\nFree= XId bytes\n" 
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The extension uses hook proce¬ 
dures to handle most of these fea¬ 
tures. The interactions among these 
hooks, FM's UndProcO, and FMExten- 
sionProcO are fairly complex and I 
can only give an overview here. A 
system-wide mouse hook procedure 
looks for a UM_RBUTT0ND0UN message 
and activates the popup menu when 
it finds one. The extension activates 
the popup menu by setting the key¬ 
board focus to an invisible window, 
over which the menu appears. The 
invisible window allows the menu to 
have keyboard control (except for 
keyboard accelerators) within any ap¬ 
plication; its UndProcO passes all 
UM_COMMAND messages to FM via Send- 
MessageO. Before the messages reach 
FM, however, another extension 
hook function gets control and com¬ 
pares the incoming UM_COMMAND item 
with entries in a pre-initiaiized com¬ 
mand table. If it finds a match, the 
hook changes the item number (in 
wPararti to a corresponding extension 
command. FM then sees only the 
modified message and calls FMExten- 
sionProcO in response. 


The extension emulates keyboard 
accelerators in a similarly roundabout 
fashion. The same hook that filters 
UM_COMMAND messages also looks for 
MM_KEYDOUN messages and compares 
them with VK_xxx values stored in the 
command table. If a message 
matches, the hook stuffs the corre¬ 
sponding UM_COMMAND menu item into 
FM's queue. The same hook catches 
the UM_COMMAND menu item again and 
follows the same procedure as de¬ 
scribed earlier, changing it into an ex¬ 
tension command to be finally acted 
upon by FMExtensionProcO. 

Although conceptually simpler, a 
one-to-one correspondence between 
menu items and extension com¬ 
mands results in code that is harder 
to maintain. Instead, I use the com¬ 
mand table (mentioned earlier) to 
link one or more menu items to a 
single extension command. For ex¬ 
ample, any number of tool applica¬ 
tions appearing on the extension 
menu may all be bound to a single 
case in FMExtensionProcO. To add an¬ 
other menu item, you need only 
change the command table and re¬ 
compile, rather than modify the main 


Table 1 FM event types and extension messages 

A. Event Notifications Received from File Manager 

FM E VENTJ IN ITM EN U 

FM is activating extension menu 

FMEVENT.LOAD 

FM is loading extension DLL 

FMEVENTJJNLOAD 

FM is unloading an extension DLL 

FMEVENT SELCHANGE 

User changed filename selection 

FMEVENT USER REFRESH 

User invoked Refresh command 

FMEVENTTOOLBARLOAD 

FM is loading toolbar (Win32 only) 

FMEVENT.HELPMENUITEM 

User wants help for a button item (Win32 only) 

FMEVENT.HELPSTRING 

FM wants help string for a button item (Win32 only) 

B. Message Types Sent to File Manager 

FM_GETDRIVEINFO 

Get drive data from active window 

FM GETFOCUS 

Get focus type of active window 

FM GETFILESEL 

Get data about a selected file 

FM_GETFILESELLFN 

Get data about a selected file (long file name) 

FM G ETSELCOU NT 

Get count of selected files 

FM GETSELCOUNTLFN 

Get count of selected files (long file name) 

FM REFRESH WINDOWS 

Repaint FM’s display (all or active window only) 

FM_RELOAD_EXTENSIONS 

Reload all extensions from |AddOns| in WINFILE.INI 
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Listing 2 msg.c 

♦Include (windows.h> 

RegisterClass (iwndclass) ; 


♦include <dos.h> 

) 


♦include <stdio.h> 

hWnd « CreateWindow (szAppName, 

// window class name 


"MessageBoxI) Test". 

// window caption 

// dames K. Lawless 

WS OVERLAPPEDWINDOW, 

// window style 

// 2414 4th Avenue 

CW USEDEFAULT, 

// Initial x position 

// Council Bluffs, IA 51501 

CW USEDEFAULT, 

// initial y position 

// 74217.5318Compuserve.com 

CW USEDEFAULT, 

// initial x size 

II 

CW USEDEFAULT, 

// Initial y size 

// Simple program to display flaw In MessageBoxI) 

NULL. 

// parent window handle 


NULL. 

// window menu handle 

long FAR PASCAL WndProc (HWND, WORD, WORD. LONG) ; 

hlnstance. 

// program instance handle 


NULL) ; 

II creation parameters 

HWND hMainWnd=0; 



HINSTANCE _hlnst=0; 

_hInst=hInstance; 



ShowWindow(hWnd, nCmdShow) ; 


int PASCAL WinMain (HANDLE hlnstance, HANDLE hPrevInstance, 

UpdateWindow(hWnd); 


LPSTR IpszCmdParam, int nCmdShow) 



( 

MessageBox(NULL,"SysModal and\r IconQuestion", 

static char szAppNamet] = "MessageBoxI) Test” ; 

"Msg",MB ICONQUESTION1 MB OKIMB SYSTEMMODAL); 

WNDCLASS wndclass; 



HWND hWnd; 

MessageBox(NULL,"SysModal and\r IconStop" 


MSG msg : 

"Msg", MB_ICONSTOP 1 MB_OK 1 MB_SY STEJ4M0DAL); 

if(!hPrevInstance) { 

MessageBox(NULL."SysModa1 and\r IconExclamation", 

wndclass.style = CSJREDRAW 1 CSJREDRAM ; 

"Msg",MB ICONEXCLAMATION1 MB OKIMB SYSTEMiODAL); 

wndclass.lpfnWndProc = WndProc ; 



wndclass.cbClsExtra = 0 ; 

return msg.wParam ; 


wndclass.cbWndExtra » 0 ; 

) 


wndclass.hlnstance - hlnstance ; 



wndclass.hlcon = Loadlcon (NULL, IDI APPLICATION) ; 



wndclass.hCursor = LoadCursor (NULL, IDC ARROW) ; 

long FAR PASCAL WndProc (HWND hWnd, WORD message, WORD wParam, LONG IParam) 

wndclass.hbrBackground = GetStockObject (WHITEJRUSH) ; 

i 


wnddass.lpszMenuName = NULL ; 

return DefWindowProc(hWnd. message, wParam, IParam) ; 

wnddass.lpszClassName = szAppName ; 

I 



/* End of File */ 




has retired th< 
standard for 
tracking bugs. 



90 °^ 



fop **' 1 


^ta-grcM^* 


BUGBAfl" FOR WINDOWS' - THI 


“At a glance, you can tell the status of any defect or 
change order, who is responsible for correcting the 
defect or implementing the change, and when the 
updated version is expected. ” 


GENERATE POWERFUL REPORTS & GRAPHS 
IMPORT /EXPORT/MERGE DATABASES 
CUSTOMIZE THE SETUP TO YOUR NEEDS 
NETWORK SUPPORT 


FOR MORE INFORMATION, CALL: 

41 S-S67-4010 

IN EUROPE, CALL: + 47 47 1 5 47 OO 
FAX: + 47 47 15 47 Ol 

Archimedes Software, Inc. 2159 Union Street, San Francisco, CA 94123 



RCHIMEDES 

SOFTWARE 


□ Request 290 on Reader Service Card □ 








































































SOLUTIONS 

s' 

A two-day pragmatic, in-depth 
treatment of technical C/C++ topics. 

January 26th and 27th 

Kansas City, MO 

Co-Chaired by: 

Chuck Allison: Columnist for C/C++ Robert Ward: Publisher of C/C++Users 

Users Journal and Member of of X3J16, the Journal and Windows/DOS Developer's 
ANSI C++ Standards Committee. Journal and Author of Debugging C. 




This intimate, hands-on conference is a excellent opportunity for you to 
build your programming skills by working with some of the best C/C++ 
programmers around. To ensure your opportunity to work closely with 
your teachers—CALL NOW—enrollment is limited to only 150 attendees. 
Each class is a half-day (2 per day from your choice of 16) technique-filled 
session of valuable C/C++ programming instruction that provides the 
in-depth coverage you expect from C/C++ Users Journal. 


Call today for a complete course listing: 


913 - 841-1631 

or email • cujsub@rdpub.com 


Presented by 


RfD and B/C Users journal 

Technical Seminars Advanced Solutions for C/C++ Programmers 


R&D Publications, Inc. • 1601 W. 23rd St. Ste. 200 • Lawrence, KS 66046 • USA 

□ Request 256 on Reader Service Card □ 








hook procedure and also add another case to FMExtension- 
Proof). 

Any FM extension DLL is open to many other modifica¬ 
tions. Interesting possibilities might include the 'tear-off' 
menu technique presented in W/DDJ (March and April 
1994) by Paul Bonneau (this would prevent potential right 
mouse button conflicts), or 'roll-up windows' (used as al¬ 
ways-on-top menus) also from W/DDJ (Jan. 1994). You 
could use some of the techniques presented here to cus¬ 
tomize almost any Windows program, not just File Man¬ 
ager. FM makes it somewhat easier, however, since it 
loads the extension for you. 



A MessageBoxO Bug 


James K. Lawless 
Council Bluffs, IA 
74217.531 @compuserve.com 


MessageBoxO is a little Windows 
function which provides a rapid 
method of interacting with the user. 
A set of pushbutton selections com¬ 
bined with a choice of several icons 
makes the process of obtaining 
'yes/no' answers a simple one. I've 
found a slight flaw with the Message¬ 
BoxO function that may cause a pro¬ 
grammer to look for bugs where 
they don't exist. 

MessageBoxO accepts a parameter 
which consists of a set of flags en¬ 
coded into a 16-bit integer. The flags 
are used to indicate the set of push¬ 
buttons and icon that should be dis¬ 
played to the user. Specifying 
MBJCONSTOP coupled with MBJYSTEMMO- 
DAL in the flags parameter causes Mes¬ 
sageBoxO to misbehave. When this 
combination is selected, the window 
presented has a thick modal frame 
(normally associated with a MBJASK- 
MODAL option) and no longer has a 
caption. The 'stop' icon specified 
does not appear. In addition, if 
you've specified a carriage-return in 
the text parameter, it will be dis¬ 
played as a small rectangular charac¬ 
ter, rather than advancing the text to 
a new line. If you change the 
MBJCONSTOP value to MBJCONEXCLAMA- 
TION or MBJCONQUESTION, MessageBoxO 
behaves as it should. 

My sample program, MSG (List¬ 
ings 2,3,4), demonstrates this flaw by 
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Listing 3 

msg.def 

NAME 

MSG 

DESCRIPTION 

'MSG' 

EXETYPE 

WINDOWS 

STUB 

WINSTUB.EXE' 

CODE 

PRELOAD MOVEABLE DISCARDABLE 

DATA 

PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 

1024 

STACKSIZE 

8192 

EXPORTS 

WndProc 
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Listing 4 msg.mak (Microsoft C) 


EXE=. 

OBJ=. 

SRC=. 

DEF=. 

IHC=. 

RC=. 

ALL: $(EXE)\msg.exe 


#. 

# HMAKE file for nsg 

$(EXE)\msg.exe : $(OBJ)\insg.obj $(DEF)\msg.def 

link /al1gn:16 /napifull /linenuobers /nod /CO $(OBJ)\msg.»(EXE)\msg.exe. .llibcew lit*, *(DEF)\msg 
rc $(EXEl\msg.exe 

*(0B0)\msg.obj : J(SRC)\msg.c 

cl /c /AL /Gsw /Ow /W2 /Zip /Fo$(OBJ)\msg.obj $(SRC)\msg.c 


displaying three message boxes. The first and third message 
box act as they should, while the second message box con¬ 
tains the parameter combination that causes unusual out¬ 
put. 

If you've experienced this problem, don't complain to 
your compiler vendor; I have been able to create the 
problem with a number of Windows development tools. I 
assume that the fault lies in the actual MessageBoxO code 
in user. exe. □ 


in the August issue (vol. 5, no. 8), 
Leor's response to Jim Lawless's Tip 
on video page management was in¬ 
advertently truncated by the printer. 
The following paragraphs provide the 
missing text in full. 

That VDM-l board had some re¬ 
markable features, two of which were 
hardware scrolling and video “masking." 
The scrolling registers allowed you to set 
the screen origin to the beginning of any 
line in video RAM - the board's display 
logic automatically wrapped around 
physical RAM to map one full page of 
text onto the screen. The masking fea¬ 
ture independently blanked out an arbi¬ 
trary number of lines at the top of the 
video display. By combining these two features, I was able to 
write machine language programs that resided in the first por¬ 
tion of the video RAM, blanked out the RAM in which they were 
resident, and used the remaining screen real estate for actual out¬ 
put! And later, when I was finally able to afford some dedicated 
RAM boards, the video driver I wrote taking advantage of those 
scrolling registers provided me with what remains to this day the 
fastest text display device I've ever seen. 

By the way, is there anyone out there who can still recite the 
entire 32-byte Tarbell Cassette Interface hex bootstrap program 
from memory? DB 6E E6 10 C2 07 00... -Iz 
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9 End-user macro development tools (Macro Editor/Debugger, Dialog Editor and Macro Recorder) allow 
your Windows application to include an Integrated Development Environment (IDE) for macros. 

9 Free technical support, comprehensive documentation, ond numerous code samples keep your 
engineering costs to a minimum. 

9 Licensed by Symantec ond other leading software companies. Named PCMogome Editors' Choice 
among cross-application macro languages. 

9 Economical licensing terms mean you don't have to develop your own macro language. 
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C CODE FOR THE PC 

source code, of course 

NEW! Wintertree Build-in Sentry Spell-Checker Engine and ThesDB Thesaurus Engine (C/C++ API, no royalties, powerful, full source) . . . each $450 

Graphic 7.0 (high-resolution, scientific plots in color & hardcopy, contour plots, device independence).$370 

TE Editor Developer’s Kit for Windows V 4.0 (full screen editor, undo command, word processing; TER for application build-in; no royalties) $300 
C/C+ + Libraries by Code Farms (persistent C structures, ER models, dynamic arrays, database functions, Jolt Award winner; specify Cor C++)$260 
Victor Image Processing Library V3.1 (brightness, contrast, merge images, TIFF/GIF/PCX; color reduction source $395; Windows $550) . . $250 

TlirboTgX (Release 3.1; HP, PS, dot drivers; CM fonts; LaT^C; MetaFont).$250 

Crusher! V2.00 (platform-independent data compression for network transfer; beats PK & LH on binary; directory trees; portable C) . . . . $215 

TE Editor Developer’s Kit V3.0 (full screen editor, undo command, multiple windows; V3.5 with Word Processing $280).$190 

COMM-DRV Version 14 (complete interrupt-driven serial communication libraries & device drivers; full source) .$155 

Minix Operating System (Version 1.5; Unix-like operating system, includes manual; specify 5.25” or 3.5” diskettes).$150 

Delorie GCC for MS-DOS (Version 2.2.2; includes C++, assembler, DOS extender, 387 emulation; complete source code and makefiles) . . $150 

NE W! JAKE 3.0 (embeddable natural language processing engine for queries in English to databases, games, help systems, etc.).$150 

Moby Crypto II (PGP, DES, Secure Hash, UFC, MDs, Crack 4.1, Lucifer, IDEA, VCR+, large integer packs, tutorials, more; not for export) . $150 
Lisp for DOS (Kyoto Common Lisp and CLISP; KCL includes Lisp-to-C translator for building mixed Lisp/C programs, two big manuals) . . $140 

Ibrow (Version 4.1; programmer’s Windows-based editor; large files, help, undo/redo, drag-n-drop, function & type tags).$135 

Cheaper! XASM (cross assemblers & utility programs; 65xx, 68xx, 80xx; Intel or Motorola hex format; macro preprocessor) .$125 

ET NeuroKit V3.1 (back error propagation and Kohonen).$120 

NEW! OSF/Motif 1.2.3 (port of Metrolink OSF/Motif to Linux; single CPU license).$105 

SCM (portable Scheme in C, IEEE standard, includes JACAL symbolic math package; SCM-4D0/SLIB-1D5/JACAL-1 A3) .$100 

PC/IP (CMU/MIT TCP/IP for PCs; Crynwr drivers, NFS server, Bdale mailer, PCRoute/PCBridge, NDIS/ODI drivers, Beholder, more) . . . $100 

Updated! DA (disassembler for Microsoft’s New Executable (NE) binary files including Windows .exe, .drv, .dll, and .fit).$95 

Script Interpreter (a command script interpreter for DOS-based systems; C-like script language; lots of features').$90 

CELP 3.2c (Federal Standard 1016 Code Excited Linear Predictive voice sampling and encoding; voice over 4.8xbps; Unix code).$80 

CPPCOMM V3.0m (C+ + serial communications class library for DOS, Windows, OS/2, and NT; includes X/Y/Zmodem).$75 

Kier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic).$60 

Coder’s Prolog (Version 3.0; inference engine for use with C programs).$60 

PCCTS Version 1.10 (Purdue Compiler Construction Tbol Set; like YACC and LEX together with lots of additional features).$60 

Container Lite V1.87 (C+ + & FLC wrapper emulators; portable, persistent containers of arbitrary data including pointers).$50 

BigFloat (arbitrary precision floating point arithmetic and functions; includes BCD conversion).$50 

EZCalc (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easily extended).$50 

Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption).$50 

CLIPS Version 6.0 (rule-based expert system generator; Windows compatible; manuals on disk).$50 

SuperGrep (exceptionally fast, revolutionaiy text searching algorithm; also searches sub-directories).$50 

OBJASM (convert .obj files to .asm files; output is MASM compatible) .$50 

Editor Pack (20 public domain editors; micromacs 3.12, Stevie, Elvis, Moke, mg2a, DTE, Jove, Origami, CE & GRIEF).$50 

DES Encryption & Decryption (2500 bits/second on 4.77 MHz PC for on-the-fly encryption at 2400 baud; not for export).$40 

Database Pack (9 databases - simple to complex; DOS: isam, bplus, AVL, SDB, ID, gdbm; Unix: Requiem, Ingres89, Postgres).$35 

COP (poor man’s C++; C macro package which implements C++in C) .$35 

OCT (Object C Translator, essentially Brad Cox’s Objective-C Version 4) .$35 

RXC & EGREP Version 2.0 (Regular Expression Compiler and Pattern Matching; finite state machine from regular expression).$35 

Bison & BYACC (YACC workalike parser generators; documentation; includes C and C+ + grammars) .$35 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) .... $30 

GNU Awk & Difif for PC (both programs in one package).$30 

NEW! Garbage Collecting Pointers (smart C++ pointers; no need to delete; detect NULL and out-of-bounds pointers) .$30 

Crunch Pack (30 file compression & expansion programs; now includes portable ZIP).$30 

OORT (C++ray tracing code from the book by Nicholas Wilt) .$30 

OEmacs (full GNU Emacs for DOS and Windows DOS box; C++ support, etags++, lots of .el files) .$25 

CTask Version 2.22d (robust MS-DOS multitasking kernel; C functions run as light-weight processes; mailboxes, interrupts, pipes, etc.) . . . $25 

PERL for MS-DOS (Version 4.019; C, sed, awk, and shell all rolled into one language; includes hardcopy docs).$25 

GNU RCS (FSFs version of the Revision Control System; like Unix’s SCCS only better; keeps track of software development).$20 

Data 

Moby Thesaurus II (6,000 root words, 2.5M synonyms, ’’common sense”, concept related searches) .$500 

Moby Pronundator II (175,000 words & phrases encoded with full IPA pronunciation & emphasis points).$265 

Moby Part-of-Speech II (230,000 words and phrases described by prioritized part(s)-of-speech).$170 

Moby Hyphenator II (185,000 words fully hyphenated/syllabified).$105 

Moby Words II (610,(XX) words & phrases with Scrabble(tm) word list, place names, baby names, acronyms, core list for spell checkers) . . . $100 

NE W! Linux Bible (Eveiything you ever wanted to know about Linux, 700+ page book).$40 

CIA World Bank II Database (13MB of maps, 5.7M vectors; coastlines, rivers, political boundaries; 5.25” HD only).$35 

U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6,000 state boundary points).$35 

The World Digitized (100,000 longitude/latitude of world country boundaries).$30 

CD-ROMs 

BSD/386 (POSIX-compatible O/S; complete development package, full networking, kernel debugger, X11R5, DOS box; complete source code) $900 

AI CD-ROM (expert systems, neural networks, genetic algorithms, fuzzy logic, linguistics/naturallanguage).$105 

OmniMap (street-level US mapping; lots of topographical features, Windows viewer, output to many file formats).$75 

NEW! Prime Time Freeware TeXetera (complete comtents of Comprehensive TfeX Archive Network (CTAN) plus tools, annotation & indexing) . . $60 

NE W! Prime Time Freeware for AI (5GB of AI software, expert shells, languages, theorem provers, etc.).$60 

Prime Time for Unix (Volume 3, No. 1, January, 1994; over 6GB of Unix C code).$60 

Whlnut Creek Libris Britannia (over 600MB of the best of British boards; not all source included).$50 

Walnut Creek C User’s Group (Volumes 100 to 364).$40 

Updated! Plug-and-Play Linux by Yggdrasil Computing Version 1.1 (run from the CD; TCP/IP & NFS; drivers; MPEG; SCSI support; lots more) . . . $35 

Mailer’s Lookup (9-digit ZIP codes by street address, distances between ZIP codes, phone locations; on-line tool, no source code).$35 

Knowledge Media Multimedia (625MB & 13,000 files; 1,232 sounds, 179 books, 100 movies, 114 stacks, 606 programs, 214 mods) .$35 

Project Gutenberg (literature, historical documents, reference books, census data, religious documents, math constants, etc.) .$35 

Undated! Knowledge Media Languages & Operating Systems (640MB of compilers, libraries, and operating systems; source code & executables) . . . $35 

Updated! Walnut Creek XI1R6 (XI1R6 with contributed and comp.sources.x).$35 

Wblnut Creek Usenet and Simtel Unix-C (600MB).$35 

Walnut Creek Giga Games (arcade, simulations, card games, education, trivai, cheat sheets; some source).$35 

Austin Code Works Internet V&rrior #1 (PC Internet tools: Gopher, Wais, Eudora, ph, Nupop, Thimpet, TCP/IP, FAQs, drivers, docs) ... $35 

NEW! Whlnut Creek FreeBSD (Berkeley 32-bit operating system for PCs; bootable).$35 

W&lnut Creek Tbolkit for Linux (Slackware distrubtion and complete Linux archive).$35 

NEW! Hans-Ameritech Slackware Linux (automated installation, lots of applications, extra kernels, Kanji, docs, FreeBSD).each $30 


Cheaper! Knowledge Media MegaMedia I and II (images, sounds, movies).each $25 

InfoMagic CICA Windows Archive (3 CD set, complete archive).$25 

InfoMagic Simtel 20 MSDOS Archive (2 CD set, source code but lots of other stuff tool.$25 

NE W! InfoMagic Linux (2 CD set; complete source code from two Internet Linux sites; lots of contributed software).$20 

The Austin Code Works much more ... ask for catalog Voice: (512) 258-0185 

11100 Leafwood Lane FAX: (512) 258-1342 

Austin, Texas 78750-3587 USA http://works.zilker.net/ E-mail: info@acw.com 

Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA/AMEX 
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New Products 

Industry-Related News & Announcements 


Contact Information for HPl's INSTALIT/Crypto 


An incorrect 800 number for HPI was printed in the 
August New Products column. The column announced 
the release of a new version of INSTAL1T, called IN¬ 
STALIT/Crypto, which is a complete product release sys¬ 
tem that supports public and private key encryption using 


technology licensed from RSA Data Security. For informa¬ 
tion on INSTALIT/Crypto, contact HPI at (800) 448-4154. 
We apologize for any inconvenience this error may have 
caused. 


AccuSoft Enhances Imaging Library, Produces Unix Port 


Windows PRO Gold Image Format Library v4.0 is the 
latest version of AccuSoft's 32-bit imaging library for Win¬ 
dows developers who need to import, view, or manipu¬ 
late raster data. The library supports popular raster 
image file formats, including JPEG, TIFF, PCX, DIB, TGA, 
GIF, WFM, PICT, DCX, WPG, EPS, and BMP. The library in¬ 
cludes various anti-aliasing algorithms, such as scale-to- 
gray for improved display and printing, and standard 
features such as image display, printing, compression, de¬ 
compression, rotation, and scanning. Other features in¬ 


clude fast JPEG and TIFF Group 4 handling, and image ro¬ 
tation by .01 degrees. AccuSoft has also ported its imag¬ 
ing libraries to Unix, and offers the Unix PRO Gold Image 
Format Library. The Gold libraries were already available 
for Windows and the Macintosh. 

The Windows PRO Gold Image Format Library v4.0 
and the Unix PRO Gold Image Format Library v4.0 each 
cost $1,995. For more information, contact AccuSoft, 112 
Turnpike Road, Westboro, MA 01581, (508) 898-2770 or 
(800)525-3577. 


Try Out 00 Analysis and Design Tool for $79 


BOCS is an object-oriented Windows CASE tool for 
analysts and designers. BOCS lets you create language-in- 
dependent object specifications and then automatically 
generate formatted documentation (including text and 
graphics) compatible with popular word processors such 
as Microsoft Word, Word Perfect, and Lotus Ami Pro. 
BOCS also can generate code for C++, Smalltalk/V, and 
Smalltalk-80. The tool helps you capture complete sys¬ 
tem designs by offering a variety of graphical modeling 
techniques, including Petri net graphs, semantic net¬ 
works, state transition diagrams, object-message dia¬ 
grams, program unit graphics, and timing diagrams. A 
Traceability tool lets you trace requirements directly into design 
and implementation. Library management tools support 


merging or separating project work to team members. 

Normally $595, a 'pilot bundle' of BOCS is now avail¬ 
able for $79. The pilot bundle includes a limited version 
of BOCS, user documentation, the publication A Complete 
Object-Oriented Design Example, 2 ed., and selected slides 
from the company's course, Object-Oriented Require¬ 
ments Analysis. The introductory package can only save 
15 models and 15 object specifications. 

The Pilot Bundle version of the BOCS CASE tool costs 
$79, which can be credited toward an upgrade to the 
complete product, which costs $595. For more informa¬ 
tion, contact Berard Software Engineering, Inc, 902 Wind 
River Lane, Suite 203, Gaithersburg, MD 20878, (301) 

417-9884; fax (301)417-0021; info@bse.com. 


Everest Helps You Build CBT/Kiosk/Multimedia Applications 


Everest Authoring System for Microsoft Windows is 
an interactive multimedia development tool for creating 
computer-based training (CBT), performance support sys¬ 
tems, kiosk applications, and presentations. You can ex¬ 
tend Everest with third-party components; it can use 
VBXs from Microsoft, Borland, Autodesk, FarPoint, Micro- 
Help, and other companies to provide functions in areas 
such as multimedia, databases, spreadsheets, graphics, in 
teraction, and so on. The product can also call DLLs and 


routines written in Visual Basic and C++. An import fea¬ 
ture lets developers edit projects created with Intersys¬ 
tem Concepts' Summit Authoring System (for DOS and 
Windows). 

Everest has a pre-release price of $1995, after which 
it costs $4395. For more information, contact Intersystem 
Concepts, Inc, P.O. Box 1041, Columbia, MD 21044, 

(410) 730-2840;fax (410) 730-8228. 
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Make Your Windows App ProVoice Aware for Free 


First Byte has announced "ProVoice Aware," a free 
program that offers Windows developers access to First 
Byte's text-to-speech technology, several development 
tools, a runtime test environment, upgrades, and sup¬ 
port. ProVoice is text-to-speech software that the com¬ 
pany has already licensed to computer manufacturers 
(IBM, AST, Dell, etc.) and board manufacturers (Creative 
Labs, Media Vision, etc.) and that has therefore already 
found its way onto millions of machines. Under this new 
program, developers can obtain at no charge the tools 
that allow their Windows applications to take advantage 
of the millions of machines and sound boards that al¬ 
ready contain the ProVoice text-to-speech capability. 

The development tools the company offers include 
'glue' DLLs, header files, import libraries, documentation 


in WinHelp format, and sample programs with source 
code. A testing environment lets you test speech within 
your application to make sure it works correctly. As new 
versions of the development package are released, devel¬ 
opers can obtain them free of charge (planned enhance¬ 
ments include three new speech fonts for UK English, 
Italian, and female American English). The program also 
offers free technical support via First Byte's BBS service. 
For advertising purposes, the company will provide devel¬ 
opers with camera-ready art for the "ProVoice Aware' 
logo and artwork for promotions and packages. 

For more information, contact First Byte, Davidson 8 
Associates, Inc, 19840 Pioneer Avenue, Torrance, CA 
90503, (310) 793-0600; fax (310) 793-0601. 


Multilingual Text-to-Speech SDKs Available 


Lemout & Hauspie Speech Products is offering text-to- 
speech (ITS) SDKs to help programmers add TTS capabil¬ 
ity to their Windows applications. TTS software converts 
simple ASCII strings Into natural-sounding speech output. 
The company currently offers TTS SDKs for American 
English, German, French, and Spanish. Each SDK includes 
TTS evaluation software, sample programs, an API refer¬ 
ence and programming guide, language-specific soft¬ 
ware and reference guides, and a DLL with separate data 
files and sample text files. 

Lemout & Hauspie Speech Products is also including 
a new Lexicon Toolkit with its speaker-independent 


speech recognition products. The toolkit makes it easier 
to add new words to the working vocabularies of the 
company's speech recognition products, allowing devel¬ 
opers and users to add words just by typing them in or 
via software download. 

Lernout & Hauspie's TTS SDK costs $1,999, which in¬ 
cludes a license for a single copy of L&H's TSS software 
in one language. Additional languages cost $499 for a 
single license. For more information, contact Lemout 8 
Hauspie Speech Products, 800 West Cummings Park, Suite 
3100, Woburn, MA 01801, (617) 932-4118; 
fax (617) 932-9209. 


Cross-Platform Revision Control Software Moves to Windows 


DRTS is a suite of code management tools for DOS, 
SCO/UNIX, SunOS, and now, Windows. DRTS can interop¬ 
erate across all these platforms, for companies with het¬ 
erogenous development environments; the software 
tracks changes where they are made and makes it easy 
to integrate multiple sets of changes. You can maintain 
multiple concurrent releases, using DRTS to propagate 


Image Processing Toolkit Adds Engine, 

The KIPP Developers Toolkit (available for DOS, Win¬ 
dows, Windows NT, and OS/2) is a set of high-level C li¬ 
braries designed for rapid prototyping and development 
of document image processing. This version includes a 
royalty-free display engine. The KP911 engine comes 
with the Windows Toolkit; it performs subsecond image 
decompression and display, and automatically detects 
Cornerstone ImageAccel controllers and monitors. The 
KP910 display image comes with the other versions of 
the Toolkit and is equivalent to the KF-911 but does not 
include ImageAccel support. 

This version of the KIPP Developers Toolkit includes 
support for the 32-bit OS/2 evironment. New high-speed 


changes from one release to the next. 

DRTS for Windows costs $300 for a single-user DOS 
or Windows version, $500 for the UNIX version. For 
more information, contact ILSI, 6325 East Monte Cristo 
Avenue, Scottsdale, AZ 85254, (602) 991-8281; 
email: drtsinfo@ilsi.mn.org. 


scanners and printers supported by this version include: 
the Kodak IMAGELINK Scanner 500 operating at 60 ppm 
duplex, the Fujitsu M3099A scanner at 50 ppm duplex, 
the SCSI and video models of the new simplex Ricoh 
IS510 and duplex Ricoh IS520 scanners at 48ppm, the 
Panasonic KV-SP500 simplex scanner/printer scanning at 
40ppm and the KV-SP505 duplex scanner/printer scan¬ 
ning at 20ppm, and the Fujitsu PrintPartner 30i printing 
solution operating at 30ppm duplex. 

The KIPP Developers Toolkit v2.1 costs $1,495 and is 
available for DOS, Windows, Windows NT, and OS/2. For 
more information, contact Kafax Image Products, 3 Jenner 
Street, Irvine, CA 92718, (714) 727-1733;fax (714) 727-3144. 


Cains 32-Bit OS/2 Support 


C++ Coder Generates Windows and OS/2 Apps 


C++ Coder is a new Windows program that automat¬ 
ically generates C++ applications that run under Win¬ 
dows or OS/2. The program can generate ail the code 
needed for database programs, including searching, sort¬ 
ing, and querying databases, creating customized re¬ 
ports, and the user interface, including up to 50 or more 
dialog boxes. The generated program can include calcu¬ 
lations based on database fields. The code generator lets 
you create applications with complex records, such as re¬ 
cords with multiply-linked lists and arbitrary-length 


memo fields. C++ Coder produces commented C++ 
classes, including the code needed for maintaining rela¬ 
tionships between objects and referential integrity. C++ 
Coder can also automatically generate documentation to 
go with the generated application. 

C++ Coder costs $500 and includes a 30-day, money- 
back guarantee. For more information, contact Super- 
bica, 38-11 Ditmars Blvd., Suite 166, Astoria, NY 11105, 
(718) 728-5115; fax (718) 728-5148. 
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New High-Speed Data Acquisition Boards Support Windows 


Data Translation is now shipping four new boards for 
Windows-based data acquisition. Aii the boards are verified 
to FCC Class A EMI noise emission standards, and provide 
electrostatic discharge protection to 1.5k volts. All DataAcq- 
EZ boards are supported by software from Data Transla¬ 
tion. The DataAcq SDK for C programmers is S95 (free 
when ordered with a board), VB-EZ Programming Tools 
(VBXs for data acquisition and high-speed plotting) costs 
$195, and DT VEE (a graphical programming approach to 
generating data acquisition applications) costs $1,995. 

The DT23-EZ and DT24-EZ offer a choice of 16- or 12- 
bit resolution on 16 single-ended or 8 differential channels, 
gap-free data acquisition using Continuous Performance Sin¬ 
gle Channel DMA to 100kHz on a single channel or 80kHz 


across all channels, a 16-element random channel gain list, 
and 16 lines of digital I/O. 

The DT31 -EZ and DT34-EZ are 12-bit boards that pro¬ 
vide gap-free throughput to 330kHz single channel or 
250kHz aggregate, but using polled I/O rather than DMA. 
These two boards also offer jumper-free configuration, 16 
single-ended or 8 differential channels, a 512-element ran¬ 
dom channel gain list, and 8 lines of digital I/O. The DT31- 
EZ also provides two analog outputs. 

You can purchase the DT24-EZ for $695, the DT23-EZ 
for $895, the DT34-EZ for $895, and the DT31 -EZ for $995. 
For more information, contact Data Translation, 100 Locke 
Drive, Marlboro, MA 01752-1192, (508) 48 7 -3700; 
fax (508) 481-8620. 


VisualWorks 2.0 Eases Smalltalk Database Development 


ParcPIace Systems has updated VisualWorks, their ob¬ 
ject-oriented client and server tool, which includes Par¬ 
cPIace Smalltalk. This version of the product features a 
database application creator. The product supports rela¬ 
tional databases from Oracle and Sybase; support is 
planned for ODBC, and DB2 via a gateway. Applications 
written with VisualWorks are automatically portable across 
the platforms it supports (Windows, Windows NT, OS/2, 
Macintosh, and major UNIX-based systems). 

An 'ObjectLens' lets you generate object classes automat¬ 
ically from existing relational tables, or generate database tables 
from existing object classes. The Visual Data Modeler creates a 
road map used by the ObjectLens to link relational data and ob¬ 
jects. The programmer can view these relationships and save 


them in the data model. The application links to the data 
model, keeping it independent of the underlying database; 
programmers can change schemas or switch databases 
without rewriting their applications. DataForms are intelli¬ 
gent objects that contain the behavior and presentation 
needed to create, retrieve, update, and delete relational 
data. You create DataForms using customizable templates 
to automatically generate the form. DataForms provide 
data management navigation, and transaction controls. 

VisualWorks v2.0 costs $2,995 for Windows, Windows 
NT, the Macintosh, and OS/2, and $4,995 for UNIX-based 
systems. For more information, contact ParcPIace Systems, 
Inc, 999 E. Arques Avenue, Sunnyvale, CA 94086-4593; 
(408) 481 -9090; fax (408) 481-9095. 


Raindrop Software Offers email VBX and DLL 


Raindrop Software is offering new libraries to help you 
make your application compliant with the VIM, MAPI, and 
MHS mail-handling protocols. Open Mail System vl .0 is the 
DLL version of their email library, usable by any language 
that can call DLLs. OMS/VBX is the Visual Basic version of 
the library. In future versions, the company plans support 


for CompuServe, SMTP, and MCI mail. 

Open Mail System vl .0 costs $995; OMS/VBX costs 
$495 and is royalty free. For more information, contact 
Raindrop Software, 833 Arapaho, Suite 104, Richardson, TX 
75081, (214) 234-2611;fax (214) 234-2674. 


VB Btrieve Package Gets New Name, Binding across Forms 


Smithware is shipping Controls for Btrieve v2.0 (for¬ 
merly called Visual Controls for Btrieve) and DDF Builder for 
Windows v2.0. Controls for Btrieve v2.0 is a set of Visual Ba¬ 
sic custom controls that help developers build Btrieve appli¬ 
cations. The new version permits controls to be bound 
across forms, allows third-party controls to be bound to 
Btrieve, and allows Btrieve controls to simultaneously ac¬ 
cess DDFs located in different directions. 

DDF Builder lets you create and maintain Btrieve Data 
Dictionary Hies, and includes an 'index Wizard" that auto¬ 


matically creates the index definition of an existing Btrieve 
file. This version can import and export DDF definitions 
from other sources, and adds field comments to the DDF 
definition. 

Controls for Btrieve v2.0 costs $249.95 and indudes DDF 
Builder for Windows, or you can purchase DDF Builder for Win¬ 
dows separately for $129.95. For more information, contact 

SMITHWARE, Inc, 2416 Hillsboro Rd, Suite 201, Nashville, TN 
37115, (615) 860-3500,fax(615) 868-5397. 


MemCheck v3.0 Covers More Windows Functions 


MemCheck is an automatic error detection tool for 
C/C++ Windows programmers. By including a single 
header file, MemCheck can track GDI resources (device con¬ 
texts, pens, bitmaps, brushes, etc.) and pop up a message 
box that identifies the file and line number that allocated a 
resource that was not freed. The software also can detect in¬ 
valid operations, such as deleting stock or currently se¬ 
lected GDI objects, as well as invalid window or object 
handles. MemCheck can detect memory overwrites and un¬ 
derwrites, memory leaks, invalid handle/pointer usage, out- 
of-memory conditions, and other memory errors in 
GlobalAllocO, LocalAllocO, mallocO, fresO, and other allo¬ 


cation/reallocation functions. 

You can link MemCheck into your program and ship it 
to beta testers without paying royalty fees. MemCheck can 
be shipped disabled so your application runs at full speed, 
and you can then activate it on a remote machine to help 
locate the source of hard-to-replicate bugs. 

MemCheck v3.0 for Windows costs $139 and includes a 
30-day, money-back guarantee. This version supports Mi¬ 
crosoft C/C++ v7.0. Visual C++, and Borland C++ 2.0 
through 4.x. For more information, contact StratosWare 
Corporation, 1756 Plymouth Road, Suite 1500, Ann Arbor, 
Ml 48105, (313) 996-2944; fax (313) 747-8519. 
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Novell Spinoff Ships New Btrieve Version 

Btrieve Technologies is now shipping Btrieve for Windows 
v6.15, which will be followed by Btrieve for DOS v6.15. Btrieve 
v6.15 offers performance enhancements, support for data 
types larger than 64Kb, more efficient data integrity and reliabil¬ 
ity controls, and more flexible creation and manipulation of in¬ 
dexes. The Btrieve Developer Kits contain the Btrieve APIs and 
developer documentation, as well as a restricted client engine li¬ 
censed for development and testing. The separate Btrieve Client 
Engines include all Btrieve dient engine files, reprodudble docu¬ 


mentation for engine installation and operation, and a li¬ 
cense giving the developer the right to copy and distribute 
engine files, documentation, and utilities at no charge. 

The Btrieve Developer Kit costs $595 and the Btrieve Cli¬ 
ent Engine costs $995. For more information, contact 
Btrieve Technologies, Inc, 5918 West Courtyard Drive, Suite 
400, Austin, TX78730, (800) BTRIEVE or (512) 794-1719; 
fax (512) 794-1778. 


SEALEVEL Systems Ships Serial Cards for Windows 


Sealevel Systems is offering two new serial boards com¬ 
patible with DOS, Windows, and OS/2. RS-485 is an electrical 
interface that allows up to 32 devices to be connected to¬ 
gether at a distance of up to 4000 feet. The SEALEVEL ULTRA- 
485 rard is viewed by Windows and OS/2 as an RS-232 port, 
but allows the standard COM driver to be used for RS-485 
communications. The board automatically enables the RS- 
485 line driver during character transmission and disables it 
afterward, allowing the RS-485 line to be managed without 
user or software intervention. 

The SEALEVEL DUOCOM is a board that provides two RS- 
232 channels with DB-9 male connectors. The board fea¬ 


tures individually selectable interrupts (IRG 2-5, 7,10-12, or 
15) and selectable addresses, including the standard COM1- 
COM4 addresses. 16-bit address decode allows unique 
OS/2 COM: addresses (3220,4220, etc.). Optional software 
driver packages allow the user to configure and use more 
than four serial ports under Windows 3.1 and OS/2. 

The SEALEVEL ULTRA-485 costs $179 and the SEALEVEL 
DUOCOM costs $89. For more information, conatact 
Sealevel Systems, Inc, 102 West Main Street, P.O. Box 830, 
Liberty, SC 29657, (803) 843-4343; fax (803) 843-3067. 


ProtoView Ships VBX and DLL Custom Controls 


The ProtoView Interface Component Set (PICS) vl .0 is a 
new set of VBX and DLL custom controls that provide data 
entry user interface objects. A hierarchical listbox offers mul¬ 
tiple sort levels, bitmapped graphics for each hierarchical 
level, and multiple styles for colors and fonts. A date/calen¬ 
dar control allows full graphical calendar selection and for¬ 
matting of dates; just click on the calendar icon to display all 
dates of the year. A time control allows graphical 24-hour 
time selection and formatting. A numeric edit control allows 
picture masking and scientific notation formats for numeric in¬ 


put; display styles include LED readout, counter, and nor¬ 
mal. A percent bar control displays the percent completion 
of an ongoing process. A volume dial control lets the user 
turn a knob-like stereo volume control to increase or de¬ 
cease a parameter. 

PICS version 1.0 costs $249.95; source code costs $495. 
For more information, contact ProtoView Development Co., 
353 Georges Road, Dayton, NJ 08810, (800) 231-8588 or 
(908) 329-8588;fax (908) 329-8624. 


Tool Pack Provides .grp to .ini Conversion 

Tessler's Nifty Tools is a collection of 30 DOS and Win¬ 
dows utilities. GRP2INI converts Windows 3.0 and 3.1 .grp 
files into ASCII . ini files that you can edit. INI2GRP per¬ 
forms the reverse process, converting the . ini file back into 
a .grp file that reflects your changes. This process also re¬ 
claims wasted space in the .grp file, left by making addi¬ 
tions and deletions to Program Manager groups. By editing 
the items in the Startup group, you can control the load or¬ 
der of programs. By editing application paths and default di¬ 
rectories, you can move an application to a new drive or 
directory without having to re-install it. 

Other tools in the package include CFGCNTRL, a file control¬ 
ler for Windows . ini, LanManager, autoexec.bat, and conflg.sys 
files. COMSPEED determines the actual modem line speed during 
a call. CONTROLP lets batch files control printer echoing. 

COPYWA copies files along with their attribute bits. DIR2BAT per¬ 


forms a series of commands on a series of files. DVPROMPT 
lets you embed a DesqView window's switch number in the 
DOS prompt FEEF1FO enables and controls the 16550a 
UART serial chip's FIFO queues. GROWP grows your DOS 
prompt each time you shell to DOS. IFONSCRN checks if spe¬ 
cific characters appear on screen and ran conditionally 
stuff keystrokes or reboot the PQ useful for remote access 
PCs. PRTSCRFF sends a formfeed to the printer when you 
press the PrirrtScreen key. RWDIR displays files that are wri¬ 
table, excluding read-only files. SETBEEP controls the dura¬ 
tion of your PCs beep or disables it altogether. 

Tessler's Nifty Tools costs $69 for all 30 programs, or 
$29 for each individual tool (shipping and handling is $5). 
For more information, contact Tessler's Nifty Tools, P.O. Box 
1791, San Ramon, CA 94583, (510) 244-5449; 
71044.542@compuserve.com. 


IMSL Moves to NT 


Visual Numerics is shipping new Windows NT versions 
of its IMSL C Numerical Libraries and IMSL Exponent Graph¬ 
ics. The IMSL C Numerical Libraries are collections of more 
than 900 math and statistical subroutines that cover areas 
such as linear systems, interpolation and approcimation, dif¬ 
ferential equations, transforms, nonlinear equations, optimi¬ 
zation, random number generation, time series, probability, 
regression, and more. 

IMSL Exponent Graphics offers over 30 presentation- 


quality 2D and 3D graphs through high-level function calls. 
The product features a built-in interactive graphical user in¬ 
terface for plot development and prototyping; you can ma¬ 
nipulate data, including real-time rotation of 3D graphs. 
Users can choose from among 300 customizable graph at¬ 
tributes (fonts, colors line types, shading, etc.) and several 
high-performance output drivers. The NT version of Expo¬ 
nent Graphics includes a Fortran API that supports Mi¬ 
crosoft's 32-bit PowerStation compiler. 

(continued on page 80) 


October 1994 


Windows/DOS Developer’s Journal — Page 79 









The IMSL C Numerical Libraries for Windows NT costs information, contact Visual Numerics, Inc, 9990 Rich- 

$695; IMSL Exponent Graphics for Windows NT costs mond Avenue, Suite 400, Houston, TX 77042-4548, 

$895. The two bundled together costs $1,195. For more (713) 784-3131; fax (713) 781-9260. 


Soffront Offers Defect Tracking For Windows 


Soffront TRACK for Windows is a LAN-based defect 
tracking system. It lets you create and update defect re¬ 
cords, attaching complete environment as well as cus¬ 
tomer information to the defect. You can use 
query-by-example to search the defect database and 
sort, update, print, or export the results to another data¬ 
base. TRACK provides simplified report generation - you 
just pick the fields to be included in the report and it 
does the rest, including design and formatting. Report for¬ 
mats and reports can be saved, and report data can be 
transferred to a word processor for more formatting. This 


version can create trend reports to analyze how fast de¬ 
fects are being submitted and fixed, identify types of de¬ 
fects that are taking longer to find and fix, and so on. 

This version supports Microsoft mail and cc:Mail, in addi¬ 
tion to its own automatic mail. 

Soffront TRACK for Windows v2.0 costs $495 for a 
single user, $1,750 for a five-user license, and $2,995 for 
a five-user concurrent license. For more information, con¬ 
tact Soffront Software, 1806 Milmont Drive, # 169, Milpi¬ 
tas, CA 95035, (408) 263-2703;fax (408) 263-7452. 


Toolkit Offers Fax Viewing and Print Capture 


Image Maker Fax Developer's Toolkit is a developer's 
kit that helps you add fax viewing and print capture fea¬ 
tures to your Windows application. The product features 
file support and conversion (fax group 3 and 4, TIFF, 

DCX, PCX, GMP, and GIF), print capture, file folders, anno¬ 
tation support, and MAPI. Microsoft uses this product in 
its Mail and At Work products. 


A developer's starter kit for Image Maker costs 
$2,500; source code licensing is available. For informa¬ 
tion on licensing fees or a free demo kit, contact Meta- 
soft Systems Inc, 2nd FI. -575 Richards St, Vancouver, 
B.C, Canada, (604) 683-6711. 


Object Database Adds Windows API 

Itasca Systems has released version 2.3 of the 
ITASCA Distributed Object Database Mangement System. 
ITASCA provides distributed peer-to-peer processing, 
open access from multiple programming langauges, and 
dynamic schema modification. The new version provides 
performance enhancements, including improved caching 
and raw data transfer. Distributed object access is faster 
by 1000% while client data transfer is 200% faster than 
the previous release. 

ITASCA is also offering a new Windows API. This 


C/C++ interface allows PC developers to access an 
ITASCA database server (which runs on SunSPARC, IBM 
RS/6000, and DECstations) from Windows. The program¬ 
ming interface is based on the UNIX version of the 
ITASCA C and C++ APIs and is source-compatible with 
those products. 

For more information, contact Itasca Systems, Inc, 
7850 Metro Parkway, Minneapolis, MN 55425, 

(612) 851-3155; fax (612) 851-3157. 


DynaZIP VBX Brings .zip Support to Visual Basic 


DynaZIP VBX is a data compression toolkit for Visual 
Basic that lets developers add .zip file support to their 
Windows applications. The control gives your Visual Ba¬ 
sic application the ability to directly create, write, read, 
test, and modify standard . z/p files. The VBX contains 
code to operate on the file format, so it does not depend 
on PKZIP and PKUNZIP being present. 

Other features include dual progress monitors, status 
and error reporting, background processing, password 


encryption, multiple-volume ('disk-spanning") support, 
and cancellable operations. A Windows ZIP shell pro¬ 
gram is included with full Visual Basic source code to 
demonstrate how to use the VBX. 

DynaZIP VBX costs $199. For more information, con¬ 
tact Inner Media, Inc, 60 Plain Road, Hollis, NH 03049, 
(800) 962-2949 or (603) 465-3216;fax (603) 465-7195. 


Sourcerer vl.5 Provides Integrated Visual C++ Source Navigation 


Sourcerer vl .5 is a tool that integrates with Mi¬ 
crosoft's Visual C++ IDE to provide a variety of source 
code functions. Sourcerer can be activated at any time 
from within Visual C++ by selecting a button in the win¬ 
dow bar or by using hot keys. It can provide the devel¬ 
oper with a list of functions, classes, structures, macros, 
and include files used in a project, just with a click of the 
mouse. You can select one of the names in the displayed 
list, and the program will jump to the beginning of the 
corresponding section in the source code. Unlike the 


built-in browser, you don't have to save or compile your 
source to use Sourcerer. Sourcerer handles multiple file 
types, including header files, resource files, assembler, 
Pascal, Visual Basic, and . Ini files. Other features include 
the ability to comment and uncomment text blocks, ten 
user-definable bookmarks, and ten copy/paste buffers. 

Sourcerer vl .5 costs $99 and requires Visual C++. For 
more information, contact CIB software GmbH, RisstraBe 
17,80992 Munich, Germany, +49 89/143600; 
fax +49 89/14360100; CompuServe 100065,165. 
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Increasing Visual Basic’s 
Stack 

Art Rothstein 


Visual Basic's stack size is 20Kb. For most applications, this is large enough. 
Stack exhaustion problems usually are due to recursion errors. Some error-free 
applications, however, have a valid need for a larger stack. If you understand 
the format of .exe files, you can easily patch vb.exe to increase its stack size. 
Unfortunately, this straightforward method has disastrous consequences. This 
article shows you how to correctly patch vb.exe to give Visual Basic a stack size 
larger than 20Kb. 

The .exe File Format 

When you build a Windows application, you specify its stack size in the 
module definition {.del) file. This stack size gets stored by the linker as a two- 
byte word at a particular position in the .exe, where the loader can examine it 
at runtime and allocate the desired amount of stack. By locating this word in 
the .exe and changing it, you can alter the stack size for a Windows ex¬ 
ecutable. The complete .exe file format is complex, but locating the default 
stack size is simple. 

Figure 1 shows a very abbreviated schematic of a Windows executable. As 
the figure shows, locating the word containing the default stack size is simple. 
First, you read the two-byte offset at location 0X003C. This tells you the offset of 


Art Rothstein runs McKinley Systems, a small software developer in downtown San 
Francisco. He spends much of his time porting Macintosh applications to Windows. 
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the Windows NE-style header. You just add 0x0012 to that 
offset to locate the word containing the stack size. Keep in 
mind that these offsets and the stack size are in little-en¬ 
dian format, with the least significant byte first. Having lo¬ 
cated the offset of the stack size, all you have to do is 
patch it and you have a new . exe with a bigger stack. 

Patching vb.exe 

Why write about something as easy as changing an 
application's stack size? Using the algorithm just described 
shows that the stack size in vb.exe is at offset 0x0612, but 


Figure 1 Locating the default stack size in a .exe 
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Figure 2 Code fragment to patch vb.exe 


Open "VB.EXE" For Binary Access Read Write As #1 

Get #1, 1555. StackVBX 

Get #1, 82743, StackCompi1ed% 

Get «, 101254, Checksum* 

If StackVB* <> SH5000 Then GoTo ValidationError 

If StackCompiled* <> &H5000 Then GoTo ValidationError 

If Checksum* <> &HBC57 Then GoTo ValidationError 

StackVB* = &HA000 

StackCompiled* = &HA000 

Checksum* = SH1282 

Put «, 1555, StackVB* 

Put #1. 82743, StackCompiled* 

Put «. 101254, Checksum* 

MsgBox "Patch successful" 

End 

ValidationError: 

MsgBox "Validation failure" 

End 


try patching the stack size at this offset. When you next 
run Visual Basic, it will present an alarming message box: 
'A virus has been detected. Visual Basic will now termi¬ 
nate.' 

Evidently Visual Basic's initialization code computes a 
checksum that includes the value just patched. Since this 
value is not part of the memory image of the program, I 
suspected that the program must be reading the ex¬ 
ecutable file on disk. With the aid of Soft-ICE/W, I con¬ 
firmed this suspicion. I trapped OpenFileO calls until I 
found one issued by module VB, then stepped through 
the code that issued the call. This revealed that Visual Ba¬ 
sic reads the .exe header (0x0040 bytes), and computes a 
word checksum based on its contents. It uses the word at 
offset 0x0030 to locate the NE header, then reads the NE 
header, 256 bytes at a time, continuing to adjust the 
checksum based on the data read. Finally, Visual Basic 
compares the checksum with a hard-coded constant and 
displays the message box mentioned previously if the val¬ 
ues differ. I set a breakpoint at the comparison to find out 
what checksum Visual Basic computed with the new, 
patched stack size. I then patched the comparison so that 
Visual Basic would expect to see the checksum that corre¬ 
sponds to a stack size of 40Kb, instead of the original 
checksum. 

Figure 2 contains a Visual Basic code fragment to 
change the stack size to 40Kb. It applies to version 3.0, 
Professional Edition; in that version of vb.exe, the stack 
size is at offset 1555 (decimal) and the offset of the check¬ 
sum Visual Basic expects is at offset 101,254 (decimal). 
Before applying the patch, be sure to make a write-pro¬ 
tected backup copy of the unpatched vb.exe. (The Stack- 
Compiled% value in this code fragment is explained later.) 

In deciding how much to alter Visual Basic's stack size, 
you need to understand how it affects other things. Visual 
Basic's stack shares the program's DGROUP segment with 
constants, some of vb.exe' s program variables, and a local 
heap. Some program work areas are allocated from this 
heap. Of the various controls I checked, only single-line 
text controls allocate memory from the DGROUP local 
heap, typically two items totaling 144 bytes. I was puzzled 
to find that multiline text controls use the global heap 
when run with a retail Windows kernel, but the DGROUP 
local heap when run with a debugging kernel. A bigger 
stack leaves less room for the heap. With the default 
20Kb stack, the heap is 28Kb. A 40Kb stack reduces the 
heap to 8Kb. In case you need to mediate between the 


Figure 3 How to patch for different stack sizes 
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Developer's 

Marketplace 



Our editor has speed, 
a complete macro language, 
configurability, large file handling, 
compiler automation, and 
colorization. Cost? $89.95 
See for yourself. Download your 
unlimited eval copy. 

Try t complete, free eval copy tonight! 

Our BBS: 206-935-5198 
NET: ftp.halcyon.com /local/wilson 
CompuServe: WINAPA, Sec. 15 
AOL: WindowWare 
Direct: 1-800-762-8383 
Wi/son WindowWare, inc. 


□ Request 157 on Reader Service Card □ 


VB = me*: 

Visual Basic Standards 
and Practices 

This amazing book by J. D. Evans, Jr. 
defines a complete set of standards and 
naming conventions for use in managing and 
developing large applications with Visual 
Basic. Innovative, advanced diagramming, 
structuring, and programming practices 
unique to Visual Basic are described in 
detail. Required reading for 

PROFESSIONAL programmers! Book & 
Diskette: $39.90 + S & H $5.95 (UPS). 

ETN CORPORATION 

RR4, BOX 659 

MONTOURSVILLE, PA 17754-9433 
TEL: (717) 435-2202 FAX: (717) 435-2802 
CompuServe: 73641,242 


□ Request 219 on Reader Service Card D 
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. om Walnut Creek CDROM 

All of these discs are Unconditionally Guaranteed! 

★ Cica MS Windows CDROM: 4000 Windows 
programs—quarterly updates! $29.95* 

★ C User Group Library CDROM: Collection 
of user supported C source code $49.95* 

★ Source Code CDROM: 650 MB of Unix & 

DOS source code $39.95 

★ Simtel MSDOS CDROM: CIassic:650MB 
Shareware/Freeware for MSDOS $29.95* 

★ Hobbes OS/2 CDROM: 600 MB current 
Shareware/Freeware for OS/2 $29.95* 

★ Yggdrasil Linux CDROM: 32 bit O/S for PC 
w/ GNU & XI1. Source code $49.95 

★ FreeBSD CDROM: Berkeley BSD, 32 bit 

O/S for PC, w/ GNU & X11 $39.95 

★ Internet Info CDROM: 12,000 computer, 
network, and internet documents $39.95 

★ Giga Games CDROM: 3000 hot Games for 

MSDOS and Windows $39.95* 

*shareware requires separate payment to authors if found useful 

Pick up the phone and Call Now! 
1 - 800 - 786-9907 E — 

1-510-674-0783 • FAX 1-510-674-0821 

email: orders@cdrom.com 

4041 Pike lane, Suite D-691 Concord, CA 94520 
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IPX VBX/DLL 
NetBIOS VBX 


These custom controls allow a Visual 
Basic developer to write distributed, 
client/server applications. A separate 
Windows dynamic-link library (DLL) is 
available for IPX. 


NetBIOS $99 

It runs with * IPX/SPX $295 
NetWare 



10201 W. Markham, Ste. 101 
Little Rock, Arkansas 72205 
Tel (501) 221-3600 • Fax (501) 221-7412 


□ FAX #1070 □ 



UNIVERSITY of W ASH1NGTON 

College of Engineering 

The Department of Technical Communication 
presents 

a two-day course: 

Designing and Writing Effective 
Online Help and 
Online Corporate Information 

for more information, contact 
Susan G. Stone 

Engineering Professional Programs 
Tel. (206) 543-5539 
Fax (206) 543-2352 


□ Request 119 on Reader Service Card D 
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Software Development 
Career Opportunities 

Nationwide openings in Windows 
/DOS Development, Test or Support 
Clients include Hardware companies, 
Software/Systems houses, and leading 
Manufacturing & Service firms who need 
your C/C++ expertise in Applications, 
Drivers or Operating System software 
development. Also have openings in 
software development/test of 80x86 
firmware, BIOS, UNIX or PC Network 
OS, and RDBMS. Send or fax 
confidential resume to: 

Alexander & Associates, Inc. 

P.O. Box 335 Granger, IN 46530 
219-271-7811 Fax:219-272-7566 
Nationwide Recruitment and Placement 
D Request 303 on Reader Service Card D 


OSETUP 


Windows Application 
Installation Tool 

"Create installations in minutes..." 

custom display/BMP* prompts •read-me dialog 
decompression • multiple disks-huge files 
version 8c time/date checking-font installation 
Program Manager group/icon creation 
Registration Database access*INI write/create 

mlv $49.95 

Call or write for more info: 

Celtech Software 

16900 Crenshaw Blvd. # 16 
Torrance, CA 90504 
310.769.1885 

info@celsoft.com •* 
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stack and the heap, Figure 3 contains the patches for sev¬ 
eral stack size choices in 4Kb increments from 20Kb to 
40Kb. 

The StackCompiledX value in the patch is for compiled 
Visual Basic applications. Finding how Visual Basic sets the 
stack size during compilation involved more guesswork. 
Since the stack size is not configurable, I reasoned that it 
must be copied from a constant in the program - if I 
could locate that constant in vb.exe, I could patch it to 
alter the stack size of compiled Visual Basic applications. 1 
knew the value 1 was looking for (20Kb, or hex 0050), but 


vb.exe contains too many occurrences of this constant for 
me to check. The DGROUP segment, however, has only 
three such instances, two of them in string constants. The 
third follows by 0x12 bytes the string "NE", which marks 
the start of a new executable header. I patched this and 
got the desired result, a larger stack size in compiled appli¬ 
cations. 

A better way to find the correct StackCompiledX offset is 
to search vb.exe for hex string: 00 10 00 50. In an NE 
header, the stack size is preceded by the initial local heap 
size. This value is fixed by Visual Basic at 4,096 bytes. 
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X.25, SDLC, HDLC, FRAME RELAY, 
BSC ON THE PC 

Use the Sangoma SDLA card to 
provide synchronous support for your 
product that is cost effective, compliant, 
full featured, rock solid and easy to use. 

• Line speed to 180kbps 

• Compatible with all operating 
systems and environments 

• Operating statistics and built in 
datascope make your product easy 
to configure and debug 

• Primary and secondary SDLC with 
multiple addresses 

• HDLC LAPB, LAPD, NRM mode 

• CCITT 1988 X.25 implementation to 
ISO 8208 

SANGOMA Technologies Inc. 

Your communications Link 
Tel: (905) 474-1990; (800) 388-2475 
FAX: (905) 474-9223 

□ FAX #1071 0 


BE SURE! 

COPIES SOLD=COPIES IN USE 

use our 

PARALLEL PORT SECURITY 
DEVICES (only $25) 

or impossible to copy 
SECURITY DISKETTES($5) 

Extremely easy to use in DOS and 
Windows from C, C++, Visual 
BASIC, ACCESS, PARADOX etc. 

All software and code samples 
FREE. Quantity discount available. 

ROYAN SYSTEMS 

2356 18th Ave., San Francisco, CA 94116 
Ph:415-664-4632 Fax:415-664-5452 
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WINDOWS DEVELOPERS 

I specialize in finding permanent and 
contract opportunities for Windows™ 
Developers. The market is excellent for 
talented software engineers. Focus on 
recruiting for Colorado and nationwide 
positions. All fees paid by the company. 
Give me a call at 1-800-638-8903. 

— Gary Patton 
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"If you can’t See it or Measure it... 
you can’t understand it!" 

PinPoint™ 

two new Windows tools for 
one low price: $199 

• Visual Tracer™: See program 
execution flow in real time 

• Visual Profiler™: Measure function 
calling frequencies and execution 
times to 1ms. Easy-to-use graphical 
display. 

Works AUTOMATICALLY with C/C++ and 
Microsoft™ Visual Basic" 

Avanti Software, Inc. 

(800)329-8889x102 
International +1(415)329-8999 
FAX+1(415)329-8722 

90 day no-quibble guarantee 
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COMPUTER 
BOOKS 50% OFF! 

The Book Rack has the best titles 
from these great publishers & more: 

IDG 

SAMS 

QUE 

MIS: Press 
Microsoft Press 
Sybex 

at HALF OFF cover prices! For a 
current list of available titles, call or fax: 

The Book Rack 

708-627-8122; Fax 708-932-9070 

Your Discount Book Source 

We ship anywhere! 

VISA/MasterCard/Oiscover accepted 
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1 TREASURE TP\1 
HUNTERS 


In the world of software, it Is j/ 
all too easy to lose a valuable 
treasure: by editing and saving 
a program, overwriting a vital 
previous version. 

To prevent you from having to 
search in vain for buried treasures, 
APIS VERSION TRACKING SYSTEM 
for Windows enables you to access 
and use previous program versions. 

AVTS, A gem of a program 
at a diamond price. 


/ 


ARIS 

Information-Systems 

Parkstr.2, 85646 Anzing, Germany 
Phone +49-8121 -45624, Fax +49-812N 
From the USA, call 
Phone 01149-8121-45624 
, Fax 01149-8121-45625 
L Email: CompuServe 100042,1707 
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IMWHelp 


UJindoui/ Help Authoring Tool 


Professional quality help files 
in 1/4 the time!! 

• Edit text directly in IMWHelp 

• Build hypertext links to: topics, 
definitions, subjects 

• Glossary automatically created 

• Bitmaps incorporated 

• Desktop publishing features 

• Print topics, help file, customized 
reports 

• Spell check, replace verify/all 

• Easily reorganize topics, subjects, 
keywords 

• Uses Microsoft Help Compiler 

Single User: $89.95 

MC & Visa accepted, Shipping additional 

Call: IMCSI (212)319-1903 

425 Madison Ave., New York, NY 10017 
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Add ZIP/UNZIP Power to your app's! 


Y DynaZIPompTT 

I Toolkit for MicrosoffWindows' 

Finally there's an intelligent and easy 
way to incorporate reading and writing 
of industiy standard ZIP files into your 
Windows programs, without having to 
"shell" to DOS. 

DynaZIP is a high-quality ROYALTY-FREE 
set of DLLs that give you a robust API for 
reading, testing, creating, writing, and 
updating your ZIP files. Supports C/C+ + 
and VB; includes source code for a 
high-qualily Windows-based ZIP shell, 
comprehensive test/diagnostic tools, 
and full documentation/help system. 
Versions available for Win3,l and NT. 

Now only $ 249.00 w/30-day 
no-risk guarantee! 

Call today, toll free: [800] 962-2949 


Inner Media, Irtc.. Hollis NH USA (603) 465-3216. fax (603) 465-7195 


a Request Reader Service #258/FAX #1074 □ 


WINDOWS DEVELOPERS! 


Text-to-Speech 
Speech Recognition 
Speech Compression 


Software Development Kits 
now available lor Windows 3.1 ! 


Set your products apart! 
Speech is the ultimate user-interface! 


LERNOUT & HAUSPIE 


PRODUCTS 


ISPEECHl 


800 W. Cummings Park, Suite 3100, Woburn, MA 01801 
(617) 932-4118 x202 Fax: (617) 932-9209 

(800) 252-4999 x202 

CALL FOR MORE INFORMATION 


□ Request 121 on Reader Service Card a 
October 1994 


I Does your company 

provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 21,000 
serious programmers in: 

Windows/DOS 

□ DEVELOPER S JOURNAL 

Call 913*841-1631 today for 
information about 
advertising opportunities in 
Windows/DOS Developer’s Journal. 

Advanced. Serious. 
Technical. 


I Brian Osborn - Continental Europe. 

+49 431-396895 

I Ed • East I Christine - Midwest I Edwin - West 
913 - 841-1622 1913 - 841-6733 1913 - 841-1626 



□ Request 145 on Reader Service Card □ 



S/W ENGINEERING POSITIONS NATIONWIDE 


We Understand 
Programmers 
Mind* 


5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax:310-641-2900 


When the country's 
top firms look for 
the best develop¬ 
ers available, they 
turn to Bateman. 
Why? Because we 
specialize in MS 
Windows, NT, OS/ 
2 and Macintosh re¬ 
cruiting nationwide. 
So if it's time for a 
career move, give 
us a call. We un¬ 
derstand your 
skills, and the mar¬ 
ketplace for them... 
we understand you. 


R Bateman Inc. 


Bar Code Fonts 


If you write enough applications, 
sooner or later you’re going to have 
to print bar codes. And what could 
be easier than calling a font? 

Azalea Software, Inc. specializes in 
quality bar code printing tools. Call 
us today to see how much fun bar 
codes can be. 



azalea 

*9ftw»r* inc. 


Azalea Software, Inc. 
8oo 48-ASOFT 
206 952.4050 
azalea@igc.org 


D Request 163 on Reader Service Card 0 
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Dr. DeeBee™ 
OBDC Tools 

Tools for ODBC development 

Ever wonder why 
your ODBC app is 
not working? Why it’s 
just too slow? If the 
OBDC driver is OK? 

!®M©llQWCI? : Use Dr - DeeBee 

Tools to find out. 

Dr. DeeBee utilities (Check, Peek, Timer, Test, 

Spy, Replay and Info) reveal the inner workiings 
of ODBC.' 

Dr. DeeBee: The smart way to do ODBC. 

snwnE,; - 

RO. Box 91 Kendall, Cambridge, MA 02142 

61 7-497-1376 _ 

□ Request 310 on Reader Service Card n 


Write Once, Help Many ! 


HLPDK/PA 


Profession;!I Author 


The Cross-Platform 
Hypertext / Hypermedia 
Help Development Kit 

Write your help source once on your favorite text editor or with our 
sophisticated Windows based help editor, and generate help databases for 
Windows, OS/2, DOS, HTML (UNIX, Mac), MS Multimedia Viewer, 
RTF and text documents with ease. 

Use existing text documents to create complex hypermedia databases. 
Convert Windows help projects to other platforms. Add graphics, sound 
and many more powerful features to your help documents. 

Save 50% off list price ! 

Get all these and much more for only $149 ! 

Offer ends October 15.1994. List price is S299. HLPDK registered users 
can upgrade to HLPDK/PA for S50. 

Call today for your copy of HLPDK/PA 
. , . and get NewsDB - Internet News Hypertext 

mmm Database generator for free ($40 value). 


RO. Box 5517. Coralville. IA 52241. USA. 
Telefax. (319) 351-8413. CompuServe 76350.333 
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BUSS 

Data Enhancement System 

SIMPLE PLOT produces piclures of data 
with minimum effort. Tire library offers 
a wide range of facilities for drawing: 

• cartesian and polar graphs 

• contouring and surface pictures 
• presentation graphics for high 
quality output 
Extensions include: 

• 4-d plotting • geographical 
projections • fast output for real time 

data display and animation 
SIMPLEPLOT offers: 

• System independence 

• Coverage of a wide range of 
platforms including Wndow^^DOS 

• Use with C/C+ + and FORTRAN 

• 

29 Campus Road, Bradford, U.K. BD7 1HR 
Tel: +44 274 309214 Fax+44 274 370502 
Email: sales@buss.co.uk 


□ Request Reader Service #299/FAX #1089 □ 
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Create High 
Performance 
Network 
Applications 
FAST! 

Now Shipping 
Version 2.03! 

60 Day Money 
Back Guarantee! 


if 

for W indows 3.x 


0 Shared DLL resources 
supports multiple applications 
and instances. 

0 Full post processing support 
& notification via messages 
(wait, no-wait, and polled). 

0 Complete NCB and attached 
data buffer functions simplify 
memory management. 

0 Complete documentation and 
on-line API help reference. 

0 Control panel utility allows 
dynamic DLL configuration. 

0 WINDOWS.TXT compatibilty 
for DOS support. 

0 No royalties, full source with 
demos. Now only $129.00! 


SIGMA SOFTWARE RESEARCH 

702 Windridge Dr., Atlanta, GA 30350 

9 TEL/FAX (404) 992-0536 

Also available at the Programmer's Connection! 


□ Request 294 on Reader Service Card □ 


Phone Sound: Simple! 


For Windows/DOS Voice Mail & Fax Developers 



Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


1. Create fantastic prompts 
anil save time with VFE(lit®\ 
Record, crop, cut, copy, paste, 
mix, fade, echo, volume & 
more with your Dialogic™ 
D4x/12x boards. 

2. Add Voice Mail power to 
your MS Windows apps with 
TI/F DLL ™, our Tel I/F 
Dynamic Link Library. 

3. Audio Tool Box™ 
converts to and from 


Multimedia Wave (16, 8 & 
MS ADPCM), linear 16 & 
unsigned 8, plus Dialogic 4 & 
8 at any sample rate! 

4. Scribe Transcription 
Utility for DOS plays digital 
audio files in the background 
without voice mail hardware! 

5. Add Text-to-Speech 
capability to your apps with 
VoxFonts ™, our "software 
only" text-to-speech library! 


Order Now! 1-800-234-VISI 


1 Voice Information Systems: 24 N Merion Ave, Bryn Mawr, Pa 19010 I 

Tel:215-747-5035/ BBS:310-392-6610/ Fa\:l-800-234-FXlT 


□ Request 180 on Reader Service Card □ 


Unique Custom Controls 

We've got the controls everyone else 
missed. Why buy yet another package 
with a bound text box when you can 
get more? 

Our controls are easy-to-use, solid, 
and royalty-free. Free lifetime updates 
from our BBS. Source code and site 
licenses are available upon request. 

There are too many to mention here, 
so write, call, or fax us for a product 
list. Or, send us $5 for a sample disk. 

Mabry Software 

Post Office Box 31926 
Seattle, WA 98103-6925 

Voice: 206-634-1443 
Fax: 206-632-0272 
CompuServe: 71231,2066 


□ Request Reader Service # 176/FAX #1093 □ 



Diskette I/O 

Code Libraries 
Device Drivers 
VxDS 

Special Hardware 


Software for Conversion, 
Duplication, Analysis, 
and Data Recovery 


WE SPECIALIZE IN "ALIEN" 
NON-PC FORMATS. 

Write or call for a product brochure! 

W V 7^1 Ay PO Box 5700 
k7 y vJ-V^+A. Eugene, OR 97405 

(800) 43-SYDEX or (503) 683-6033 
FAX (503) 683-1622 

□ FAX #1087 a 


WINDOWS 

JOBS! 

TechniSource, a leader in software 
engineering contracts and consulting is 
looking for MS WINDOWS professionals for 
Chicago area and national locations: 

” Multimedia (video conferencing) 

* Device Drivers, Internals, GDI 

* 3.1, 4.0, NT 

* OLE 2.0 

* SDK, DLL’s, VXD's 

* Visual C+ + 

* MS Test 

Highly compensated long term positions on 
cutting edge technology. 

TechniSource 

621 Plainfield Rd #301 Dept. WDD941001 
Willowbrook IL 60521 800-330-3308 
fax 708-887-1097 or 305-493-8603 (FL/Nat'l) 
CompuServe: 74407,3366 EOE 


o Request 138 on Reader Service Card □ 


BRIDG/T™ 

Your Windows <& DOS - dBConnection 



Bridgit is a full featured database engine that provides 
easy to use functions for creating, reading, updating 
and indexing dBase-lll+ and Clipper files. 

With Bridgit you create your application only once...then 
convert it to Windows or DOS using either dBase-ill + or 
Clipper files. 

Order the ultimate database engine for Visual Basic 
and Visual C++ for just $69.95. 


Unelko Corporation 

Tel:(602) 991-7272 • Fax:(602) 483-7674 


a Request 306 on Reader Service Card □ 


* 8 ? 

• Design and test 
tabbed dialogs 
using our powerful dialog editor 

• Dialog editor generates resource scripts 

• Use with C, C++, PASCAL, etc. (not a VBX) 

• Easily convert multiple dialogs into one 
tabbed dialog 

• Upgrade existing applications quickly 

• No royalties, with DLL source code 


1 

| lift labs 1.0 


' Ewit: 

,1 

! 

j 


Tabbed Dialogs 

y ffoi WtadtrWU \ 

! \ 


: j C Source. DLL j 

| No Royalties 


i 


Call today for free information 

SftTabs 1.0 (incl. DLL source code) $149 
S&H additional VISA/MC accepted 



(201) 366-9618 Fax: (201) 366-3984 

11 Michigan Ave Wharton, NJ 07885 

□ Request Reader Service #297/FAX #1090 p 


TCP/IP Tools 


Why write low-level TCP/IP code when you 
can quickly and easily incorporate 
high-level components? 



DIF SlHfF T FfF 

PowerTCP lets you add TCP/IP protocols to 
your application without coding them yourself! 

VB & C/C++ Programming Interfaces 

Custom Development Available 


DART 

COMMUNIOMOHS 

6 Occum Ridge Road 
Deansboro NY, 13328-1008 


Phone: 315.841.8106 
Fax: 315.841.8107 

Sales@dart.com 


□ Request Reader Service #233/FAX #1079 □ 


“I wish this was a 
Windows Application” 

You need the power and simplicity of 
ClearWin Pius™ with Salford’s 32-bit 
C++ compiler for DOS, Windows 3.x and 
Win32 (Windows NT and Chicago). 
Using formats, ClearWin Plus offers an 
innovative approach to the problem of 
producing maintainable Windows code. 
Write a realistic prototype quickly in less 
than 100 lines of code with no previous 
Windows programming experience! 

ASK FOR A FREE 
. DEMO DISK 
TODAY 


Adelphi House, Adelphi Street, Salford M3 6EN, UK 
Tel: (+44) 0161 834 2454 Fax: (+44) 0161 834 2148 
_ Fax toll free from USA: 1 800 562 6875 

□ Request 286 on Reader Service Card □ 
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Summary 

Stack size is one of those things that Visual Basic did 
not intend to be user-configurable. However, there are 
valid uses for an increased stack size, and only a little 
trickery is required to achieve it. Be sure you make a safe 
backup copy of your vb.exe before patching it. □ 




Developer's 

Marketplace 


C and C++ DOCUMENTATION 


!! NEW VERSION 6.0 !! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59)Counts path complexity, 
counts comments, code, 'O statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($69) Creates cross-reference of 
local/global/define/parameter identifiers. 

• C-DOC ($199) PACKAGE All 5 programs 
integrated as DOS program (<10,000 lines) 
V6.0 C-TREE Windows grapic-tree viewer. 

• C-DOC Professional ($299) DOS, Windows 
OS/2. 3-ring binder/case. <1,000,000 lines 

« 30-DAY Money-back guarantee CALL NOW 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga 
ONT, Canada Voice/Fax (905)-858-44i 
L5N-4M1 Demo/BBS (905 -858-191 


□ Request Reader Service #134/FAX #1058 □ 


DICE IS LOOKING FOR 


...data processing, engineering and 
technical writing professionals to fill 
open positions nationwide. DICE is 
a FREE online job search service 
providing detailed information about 
current contract and full-time 
positions across the USA. It’s a 
confidential, easy to use, no cost 
way to search for a new job. 



DATA PROCESSING 
I NDEPENDENT 
CONSULTANT’S 
E XCHANGE 


ONLINE Number 


515 - 280-3423 


Contact DICE via 1200/14400 baud 
Modem, 8-N-1. 

A service of D&L Online, Inc. 
515-280-1144 


□ Request 161 on Reader Service Card O 


S N 

Developer Jobs! 

1 - 800 - 231-5920 

Commercial software developers should con¬ 
sider registering with Scientific Placement. 
Specialists in R&D jobs for software engi¬ 
neers, SQA, product managers, etc. 
Nationwide contacts with both large and small 
companies including equity start-ups. Many 
clients develop and publish commercial soft¬ 
ware products. Most develop for Windows, 
NT, Macintosh, OS/2, and Unix based plat¬ 
forms. We also recruit in other leading edge 
technology areas such as PDA, low level and 
real-time, compilers, etc. Managed by gradu¬ 
ate engineers. Send resume or call to get an 
assessment of your marketability. Never a fee. 

Scientific Placement, Inc. 

Internet: lej@scientific.com 

CompuServe: 71250,3001, AOL: davesmall 
SPI8, Box 19949, Houston, TX 77224 
(713) 496-6100 Fax: (713) 496-0373 
SPI8, Box 71, San Ramon, CA 94583 
(510) 733-6168, Internet: bge@spi.com 
SPI8, Box 4270, Johnson City, TO 376C 
854-9444 Fax: (615) 854-9454 


□ Request 295 on Reader Service Card □ 





SOURCE CD ROM s 

LANGUAGE/OS 

LARGEST collection of Source for 
Compilers, Libraries, & Docs for 
computer languages and OS on CD... . 
gvp'. $34.95 (updated) _ 

LANGUAGE/OS II 

LARGEST collection of Source just 
got bigger!! A perfect companion to 
Language/OS, with more source for 
compilers, function libraries, and docs 
for standard and research 
languages & OS .... $34.95 

*****Buy both for only $64.95***** 

KNOWLEDGE MEDIA Inc. 

(800) 78 CD ROM (916) 872-7487/FAX (916) 872-3826 
VISA and MASTER CARD accepted 
436-B Nunneley, Paradise, CA 95969 USA 

O Request 275 on Reader Service Card □ 


Spend your time writing your App 
...Not wading through 
DDK documentation!! 
Hardware control for Win32™Apps 
- without the Device Driver Kit 
vPort I/O 

^Memory I/O 


^Interrupts 

Ask us about Alpha™, PowerPC™ and 
Chicago versions. 

BlueWater Systems I 

Jp".(206)771-3610 | 

(206)771-2742 Fax 
73514.132@compuserve.com I 
NT version $595 
Royalty free runtime 
Visa,MC, Approved PQ f 


DDK 
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11 Add support for 36 raster file formats instantly!" 

AccuSoft Image Format Library 

Import - Export - Scanning - Conversion - Compression 
Printing - Display - Image Processing - Special Effects Version 


New 

§ 


AccuSoft has done it again! You asked for more formats: we 
added 24 new formats. You asked for more speed: we made it 
faster. You wanted advanced color reduction: we added a superb 
new color reduction technology. You wanted thumbnails: we 
added them. You asked for it, you got it: Version 5! 

Guaranteed to read all raster images in 36 formats! We have 
offered this guarantee for nearly 3 years. This guarantee means 
you and your customers get the highest quality imaging technology 
available. 

Incredibly easy to use interface that simplifies development! A 
single function call provides support for all 36 formats with 
autodetect. Simply pass the filename to our library! And if you 
want complete control, we give you that also. 

Al standard image compression techniques are supported 
including Group III, Group IV, JPEG, LZW, Huffman, Packbits, and 
Runlength. You can even create your own file format with Version 
5 using the built-in compression. 

Functions provided include rotate, invert, zoom, pan, scroll, resize, 
crop, sharpen, contrast, brightness, color reduction, gamma control, 
palette control, multi-page display, matrix convolutions, 
thumbnails, and much more. 

Performance is of the utmost importance to our customers and we 
continually push the envelope to achieve faster image loading, 
display, processing and compression. Version 5 is the best 
performer yet! 

We are now the acknowledged leader in imaging toolkits, and 
Version 5 is the next step in the evolution of high performance 
imaging! Call now to order or to get more information about our 
complete line of imaging toolkits. 



Wr3 




CALS 


XPIVi 


®esi] 


New 5.0 features: 

Faster image loading & processing 
All new. advanced color reduction 
It 1 New levels of flexibility 
$ Create your own format 
New compression algorithms 
^ Display while decompressing 
& Status/cancel for all functions 
•J? 24 new raster formats supported 
& Automatic thumbnails of any size 
& New scanning features 
*1/ I/O replacement for total control 
& Plus many more new features 


& 


New Formats'. 

Now Supporting 

Photo CD 


Pro Gold versions 



Fastest imaging toolkit available 
Lightning fast Group IV support 
Fastest JPEG available at any price 
Superb quality scale-to-gray display 
One hundredth of degree rotation 
Cornerstone ImageAccel supported 
Read any image sub-region 
Multi-page, high speed scanning 




All Platforms Supported! 








MAC 





Guaranteed to read all raster 
images in existence in the 
supported formats. If you can 
find a valid image we don't 
read, send it to us and we will 
make it work. 


(800) 525-3577 

(508) 898-2770 
(508) 898-9662 FAX 


High Performance Imaging 


Copyright 1994 AccuSoft Corporation. All rights reserved. AccuSoft Corporation 112 Turnpike Rd. RO. Box 1261 Westborough, MA 01581 
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Build VxDs In C/C- 

No Assembly Required! 


Nu-Megas Soft-ICE/W™ And Vireos VtoolsD 1 " 
Now Bundled To Give You More VxD Building 
Power Than Ever Before! 


Develop with VtoolsD 

VtoolsD is a comprehensive toolkit that brings VxD devel¬ 
opment out of the dark ages of assembly language into 
the age of C/C++, and visual programming. 

Now you can enter the realm of Windows system pro¬ 
gramming equipped with tools that leverage your exper¬ 
tise in high level languages. 

VtoolsD was designed 
explicitly for C and C++ 
programmers. You can 
build great VxDs without 
writing one line of assem¬ 
bly language. Build your 
next VxD with VtoolsD 
and save time without 
sacrificing performance. 

VtoolsD Includes: 

■ QuickVxD™ — a visual 
programming code 
generator for fast starts 
on new VxD projects 

■ Optimized C-callable 
VMM/VxD service 
libraries 

■ The only Class Library for VxD programming 

■ Customized ANSI C Run Time Library coded 
specifically for VxDs 

■ Complete library sources 

■ Full support for Microsoft Visual C++ 32-bit 
Edition 

■ Documentation for all interfaces and classes 

Get VtoolsD for Windows 3.1, Only $495! 



Debug with Soft-ICE/W 

One of the biggest problems with writing a VxD is debug¬ 
ging it. A VxD runs in 32 bit flat mode at level 0. This 
opens the program up to an entire range of potential bugs 
that you would not encounter in other Windows modes. 
Soft-ICEAA/’s powerful break points and its ability to debug 
your entire VxD at source level, make it the ideal tool for 
VxD debugging. 

Not For VxD’s Only 

Soft-ICE/W takes you inside Windows! Debug and 
explore with power and flexibility not found in any 
other Windows Debugger! 
Soft-ICE/W allows you to 
debug at the systems or 
applications level or simply 
learn the inner workings of 
Windows. 

■ Debug drivers and 
interrupt routines 

■ Debug interactions 
between DOS, 

TSRs and Windows 
Applications 

■ Debug Windows and 
WIN32S applications 

■ Debug programs in 
DOS boxes 

■ Display valuable sys¬ 
tem information (from 

the total memory occupied by a Windows application, to 
the complex internal structures of Windows) 

Get Soft-ICE for Windows, Only $386! 


GET BOTH IN THE VxD BUILDER’S BUNDLE NOW AND SAVE! 


v 

Vireo Software 

385 Long Hill Road 
Bolton, MA 01740 



Risk Null 

30 Day Money Etack Guarantee 

( f Nu-Mega 

j TECHNOLOGIES INC 
You’re hot Alone. 

P.O. Box 7780 
Nashua, NH 03060-7780 


CALL 1-800-4-NUMEGA () 
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